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Section 1 


INTRODUCTION 


The 4027 Color Graphics Terminal belongs to the class of machines popularly known as 
“smart terminals.” It is a computer terminal that carries communications between the 
operator and a host computer. In addition, the 4027 contains its own microprocessor and 
supporting electronics. With this electronics, the 4027 responds to its own set of 
commands, independently of the host computer. 

The 4027 is not intended to be a stand-alone computing system. Rather, its computing 
ability complements that of the host computer, enabling the user to make full use of the 
4027’s information display capabilities. 


ABOUT THIS MANUAL 

The purpose of this manual is to acquaint you with these capabilities and to describe in 
detail the commands to which the 4027 responds. You can then use the full potential of 
the 4027 for problem solving and information display. 

Two assumptions are made concerning the reader of this manual. First, the person should 
be familiar with computer operations in general and with at least one programming 
language. Second, the person should have access to the 4027 Operator’s Manual. 

The 4027 Programmer’s Reference Manual is organized along broad functional lines. 
Section 1 gives an overview of the 4027 Color Graphics Terminal. Each succeeding 
section explores one class of commands related to a basic terminal function. 

An alphabetical Command List is included following the list of Tables to provide an easy 
means of locating the various commands in this manual. Also, Appendix J is an 
aiphabetical command list which includes additional information. 

The 4027 has a variety of parameter settings, most of which are set by command, and the 
action of other commands may be influenced by these settings. When this is the case, 
commands are cross-referenced. 
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RELATED DOCUMENTATION 

Information related to programming for the 4027 can be found in the following 
documentation: 

4027 Color Graphics Terminal Operator’s Manual 

4010BO1 -4010BO5 Plot 10 Easy Graphing Software documentation 

A 4027 Programmer’s Reference Guide, containing a summary of information in this 
manual, is also available. 

The 4027 can be used in a polling environment. For information reiated to polling, see the 
4020 Series Polling Reference Manual. 

THE 4027 COLOR GRAPHICS TERMINAL 

The 4027 Color Graphics Terminal (Figure 1-1) is an interface between the terminal 
operator and a host computer. It is designed especially for creating color graphic 
displays, including a variety of character fonts, in 64 different colors. In addition, it may be 
used for applications involving text editing and display and processing of forms. 

The 4027 consists of a display unit and a keyboard attached to the display unit by a thin 
cable. The display unit contains a 13 inch, refresh-style color cathode ray tube (crt), a 
microprocessor with supporting electronics, and a standard RS-232 interface. The 
terminal operator types information on the keyboard. Information from both the keyboard 
and the host computer is displayed on the crt. 

4027 terminal operations are controlled by the microprocessor and its associated 
firmware (programs for the microprocessor which are stored in Read Only Memory chips, 
or ROMs). With this firmware, the 4027 responds to several dozen commands, 
independently of the host computer. These commands determine settings of the 4027 
system parameters, control the screen display, and perform various functions useful in 
applications programs. 

4027 Features 

• Workspace and Monitor — The 4027 display memory can be divided into two 
portions (or scrolls). One portion, called the workspace, serves as a composition 
area for creating color graphics, editing text, filling out forms, or displaying the 
results of applications programs. The monitor portion of memory stores messages 
to and from the computer and any 4027 commands typed on the keyboard. 
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• Split Screen — The 4027 screen can be divided into two areas or windows, 
corresponding to the two portions of the display memory. The upper area is the 
workspace window and displays information from the workspace. The lower area 
Is the monitor window and displays information from the monitor without writing 
over the workspace display. The portions of the screen allotted to each of these 
windows are set by command. 

• Color Graphics — The 4027 can store and display graphs and a variety of 
geometric shapes in the workspace. Solid lines and several types of dashed lines 
can be drawn. All graphs, shapes, and lines can be displayed in any of 64 colors. 

• Color Display — The 4027 can display up to eight of it’s palette of 64 colors at one 
time. Eight colors are assigned to color numbers C0-C7. If other colors are 
desired, the colors set by each of the color numbers may be changed by using the 
MAP, RMAP, or MIX commands. 

• Visual Enhancements — Characters can be displayed with the standard (CO) 
attribute (white on black background) or on one of six other colors on a black 
background. In addition, the characters may be inverted (black characters on a 
colored background). Characters may also blink between colors, or between 
inverted and noninverted. In addition, various combinations of characters and 
background colors may be defined by the operator to provide an even wider 
variety of attributes. Screen contrast is controlled manually by the operator but 
screen brightness is internally set. 

• Scrolling — When either the workspace window or the monitor window is full, 
information in that window scrolls up to display additional information. Infomation 
scrolled off the screen is saved as long a memory is available: the scrolled text 
may be reviewed by scrolling down. 

• Forms — The workspace can display a form. When the operator has filled in the 
blanks of the form, the data in these blanks can be sent to the computer with a 
single command. 

• Locally or Remotely Controllable — Commands to the 4027 can be typed on the 
keyboard or sent from the computer. 

• Programmable Operating Parameters — Various operating parameters (such as 
parity, workspace margins, tab stops, etc.) can be set by commands given either 
from the keyboard or from the computer. 

• Programmable Baud Rate — The 4027 baud rate can be set by command. 
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• Buffered Operation — In buffered mode, a line of text (up to 80 characters) in the 
monitor is saved for proofing or local editing before it is sent to the computer. 

• Programmable Keyboard — Almost all of the keys on the keyboard can be 
programmed to generate a different character or character string than the default 
one. This allows commonly used character strings or commands to be generated 
by pressing a single key. 

• Local Text Editing — Using the editing keys or commands, one can edit text held 
in the workspace before sending it to the computer. 

• Status Messages — The 4027 can display status messages which indicate 
parameter settings, the command character, and the amount of unused memory in 
the terminal. 

• Modules — Display unit and detached keyboard. The keyboard can be located up 
to eight feet from the display unit. 


Optional Features 

• Printer Copies — Text in the workspace or in the computer can be copied on a 
Tektronix 4642 Printer. The printer cannot copy graphics. 

• Hard Copies — The 4027 can make permanent copies of all information on the 
screen using a Tektronix 4632 Hard Copy Unit. The 4632 Video Hard Copy Unit 
with Option 6 (Enhanced Gray Scale) will copy forms and graphs just as they 
appear on the 4027 screen (substituting gray scale for color). 

• Additional Graphics Memory — Standard graphics memory is 48K. Options 
provide 96K, 144K, or 192K total graphics memory. 

• Additional Display Memory — Standard display memory is 8K. Options provide 
either 16K or 32K bytes total display memory. 

• Optional Interfaces — Options allow the 4027 to use a 20 mA current loop or an 
RS-232 peripheral communications line. A polling interface allows the terminal to 
operate as one of several “slave” display stations which communicate with the 
computer through a polling controller. 

• GPIB Interface — The 4027 can commirnicate with four Tektronix 4924 Digital 
Cartridge Tape Drives and two Tektronix 4662 Interactive Digital Plotters, using a 
GPIB (General Purpose Interface Bus). 
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• Half Duplex — A half duplex optional interface is available. With this option the 
DUPLEX command is added to the terminai command set. 

• Alternate Character Fonts — The Math Characters font provides a variety of 
symbols useful in mathematical applications. A number of fonts containing 128 
characters each may be assigned by the user for graphics or other purposes. 32 
fonts are available, of which 30 may be user defined. 

• Rulings — The Ruling Characters font provides a variety of ruling characters. 
Using this font, the 4027 can draw horizontal and vertical rulings to highlight the 
structure of a form displayed in the workspace. 

• Polling Controller — The 4027 can act as a “polling controlier” to supervise 
communications between several 4027 or 4024/4025 “slave display stations” 
and a host computer, using IBM 3270-Bisynchronous EBCDIC protocol. 


THE SPLIT SCREEN: WORKSPACE AND MONITOR 

Information sent to the display unit from the keyboard or the computer is stored in a part 
of the terminal’s memory called the display list. This display list can be divided into two 
sections or scrolls — the workspace scroll (or simply workspace) and the monitor scroll 
(or simply monitor). 

Information from the keyboard can be directed into either scroll, as can information from 
the computer. Each scroll has specific uses, and the 4027 processes information in the 
workspace differently than it processes information in the monitor. 

The workspace serves as a composition area. The operator can use it to create text to 
send to the computer, to edit text, to create graphics, to create or fill out forms, or to 
display results of applications programs. Text typed into the workspace is stored there 
until the terminal is commanded to send data in the workspace to the computer. Data is 
not transmitted as it is typed. 

The monitor is used to display commands typed on the keyboard and messages to and 
from the computer. The monitor cannot contain forms or graphics. In general, the monitor 
aliows (1) the operator to communicate with the terminal or the computer, and (2) the 
computer to issue error messages or prompts, without this information being written over 
the contents of the workspace. 

There is always a monitor defined; hence there is always a monitor window of at least one 
line. There may, however, be no workspace defined. If no workspace is defined, there is no 
workspace window; the entire screen is devoted to the monitor. 
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Figure 1 -2. The Split Screen; Workspace and Monitor Scrolls. 


When the terminal is powered up or RESET (using the reset button on the back panel), the 
monitor window occupies the entire 34 lines of display, no workspace is defined, and text 
from the keyboard and text from the computer are directed into the monitor. Appropriate 
commands to the 4027 define a workspace, select the number of lines in each window, 
and direct text from the keyboard and text from the computer into the desired scrolls. 


NOTE 

If the command character is not known, pressing the shift STATUS key 
displays the command character, whether the terminal is in buffered or 
unbuffered mode, and the number of blocks of display memory available. 
The command character must be known so that commands may be given 
to define the workspace and monitor regions of the display. If the 
workspace and monitor areas have not been defined, text will not appear 
on the screen. 
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For each scroll there is a cursor — a pointer in the display list indicating where the next 
character entered in the scroll will be stored. The cursor appears on the screen as a 
bright underline one column wide. Only one cursor will be visible at a given time. (There 
may be brief periods, while the terminal performs certain routines, when neither cursor is 
visible.) 

If the workspace window is full and additional text is entered in the workspace, the 
workspace automatically scrolls up to display the new text. Text scrolled off the screen is 
saved in the display list so long as that memory capacity is not exceeded. The operation 
of the monitor is similar, except that information scrolled off the monitor window will be 
discarded if that memory space is needed for other purposes. 

Scrolling commands and scrolling keys roll the workspace and monitor up and down, 
independently, to display various portions of text. 


THE 4027 KEYBOARD 

The 4027 keyboard is shown in Figure 1-3. 



2657-1 


Figure 1 -3. The 4027 Keyboard. 


As indicated in Figure 1 -3, the keys on the 4027 keyboard fall into three categories: 
ASCII keys, cursor/numeric pad keys, and function keys. 
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ASCII Keys 


The ASCII section of the keyboard resembles an 
ordinary typewriter keyboard. Each key in this 
section, except the BREAK key, sends a character 
of the ASCII code to the computer. (See the ASCII 
Code Chart, Appendix B.) The BREAK key sends a 
break signal which interrupts the computer’s opera¬ 
tion. 



ASCII KEYS 


Cursor/Numeric Pad Keys 


The cursor/numeric pad is the group of 11 keys to 
the right of the ASCII section of the keyboard. This 
group of keys functions either as a cursor pad or as 
a numeric pad. 



CURSOR/NUMERIC PAD 


When the NUMERIC LOCK function key is off 
(unlighted), the group functions as a cursor pad. In 
this mode the four keys marked with arrows move 
the cursor and the two keys marked with triangles 
scroll the display list. If the terminal has been given 
the ENABLE command, the four keys marked with 
arrows move the crosshair in the direction indicated. 
The zero/crosshair (0/-I-) key and the ENABLE com¬ 
mand may be used to ENABLE the crosshair on the 
4027. The remaining pad keys have no effect. 



When the NUMERIC LOCK function key is on 
(lighted), the group functions as a numeric pad, 
generating the digits 0-9 and the decimal point 
(period). The shifted versions of the appropriate pad 
keys still move the cursor and scroll the display list. 


NUMERIC LOCK 



NUMERIC KEYS 
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Function Keys 


The function key group consists of the ERASE key, 
the PT (Pad Terminator) key, and the sixteen keys 
along the top of the keyboard. 

The ERASE key is at the extreme upper left of the 
ASCII section of the keyboard. This key erases 
whichever scroll (workspace or monitor) receives 
text from the keyboard. 


WTrTTTTXTTTTTTTT-l [ 
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FUNCTION KEYS 


The PT (Pad Terminator) key is the large key to the 
right of the cursor/numeric pad. The default defini¬ 
tion of this key is “undefined.” 

The sixteen keys along the top of the keyboard are 
divided into four groups of four keys each. Each key in 
the rightmost group includes an LED which, when 
lighted, indicates the key is “on.” These sixteen keys 
have the following definitions. 


F1 — Undefined 
F2 — Undefined 
F3 — Undefined 
F4 — Undefined 
F5 - HOME 
F6 — Undefined 
F7 — Undefined 
F8 - SEND ** 

F9 - DELETE CHARACTER 
F10 - DELETE LINE 
F11 - ERASE & SKIP 
F12 - INSERT LINE 
F13 - INSERT MODE* 

F14 - TTY LOCK * 

F15 - NUMERIC LOCK/LEARN * 

F16 - COMMAND LOCKOUT/STATUS * 

* — lighted keys 

** — The SEND key has no definition until 
programmed. 
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Function keys F1-F4 and F6-F8 have default definitions of “undefined”; these keys cause 
no action unless they are programmed. 

Function key F5 is the HOME key. Pressing this key returns the visible cursor to its 
“home” position in ro\w 1, column 1 of its scroll. 

Function keys F9-F16 perform the functions indicated by their keyboard labels. These 
keys are discussed in detail in the 4027 Operator’s Manual. 

The default definition of the SEND key is “undefined.” Since the 4027 command set 
includes two different types of SEND commands, the shifted and unshifted versions of the 
SEND key may be programmed, each with a different type of SEND command. 

The LEARN key is the shifted version of the NUMERIC LOCK key. The STATUS key is the 
shifted version of the COMMAND LOCKOUT key. Neither the LEARN nor the STATUS key 
is a lighted key; each operates independently of the corresponding unshifted key. 

The action of the DELETE CHAR, DELETE LINE, INSERT LINE, INSERT MODE, and LEARN 
keys can be duplicated by 4027 commands discussed later in this manual. 

There are no 4027 commands which correspond exactly to the HOME, ERASE & SKIP, 
TTY LOCK, NUMERIC LOCK, COMMAND LOCKOUT, or STATUS keys. The action of the 
HOME, ERASE & SKIP, and COMMAND LOCKOUT keys can be duplicated by certain 
command sequences discussed in later sections of this manual. There are no command 
sequences which duplicate the action of the TTY LOCK or NUMERIC LOCK keys. 


NOTE 

In a 4027 which contains a Polling Controiler (Option 11), the definitions 
assigned to some of the function keys wiii be different than those 
discussed in this section. Refer to the 4020 Series Foiling Reference 
Manual for relevant details. 
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Programmable Keyboard 

Most of the keys on the 4027 keyboard can be programmed with definitions other than 
the default ones. This allows the operator to generate commonly used character strings, 
commands, or command sequences by pressing a single key. 

All of the keys on the keyboard can be programmed except the following six keys. 

• The rightmost three iighted function keys — TTY LOCK, NUMERiC LOCK, and 
COMMAND LOCKOUT. (Neither the shifted nor the unshifted versions of these 
keys can be programmed.) 

• The three ASCil keys - SHIFT, CTRL, and BREAK. 

Key programming can assign different definitions to the shifted and unshifted versions of 
the same key. For example, the upper case A key and its unshifted version, the a key, may 
be programmed with different definitions. 

Function keys F1-F4, F6-F8, and the PT (Pad Terminator) key have no definitions 
assigned to them. These keys are reserved specifically for programmed definitions. The 
SEND key (function key F8) is usuaily programmed with some version of the SEND 
command. 
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4027 COMMAND STRUCTURE 


HOW TO FIND COMMANDS IN THIS MANUAL 

The 4027 responds to several dozen commands. This manual is organized functionally. 
Each command, with a description of its structure and what it does, is listed in the 
appropriate section of the manual: the UP and DOWN commands are described in 
Controlling the Display, the HRULE and VRULE commands in Forms and Form Fillout, and 
so forth. The first section in which a command appears contains a complete description of 
the command syntax. 


If the presence of certain modes or settings affects the action of the command, these 
effects are discussed in the relevant section. The TAB command, for example, causes a 
different action when the terminal is in form fillout mode, and the action of TAB in form 
fillout mode is discussed in the Forms and Form Fillout section. 


In addition to these command descriptions. Appendix J is a convenient alphabetical 
listing of commands and additional information. Also, following the Table list in the 
Contents section is an alphabetical list of commands including the section and page 
where each command is found. 
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THE FORMAT OF 4027 COMMANDS 

Each 4027 command is represented by an English-style ASCII string. In addition to the 
English-style commands, the 4027 graphics commands have counterparts on existing 
4010 Series terminals and PLOT 10 software. When these commands are sent from the 
computer, they can be represented using the 4010-style codes. 

A 4027 command consists of four parts: 

• The command character 

• The command keyword 

• The command parameters 

• The command terminator 

The command character is a unique, user-selectable character that does not normally 
occur in text. This character informs the 4027 that the information which immediately 
follows is a command. The exclamation point (!) is selected as the command character 
before the 4027 is shipped from the factory. The operator or programmer can change the 
command character by using the COMMAND command. (See Selecting the Command 
Character later in this section.) The exclamation point (!) is used as the command 
character throughout this manual. 

The command keyword is a single word that identifies the command to be executed. This 
keyword can be spelled out entirely or, if it contains more than three letters, it can be 
truncated to the first three letters. Two exceptions are the DISCONNECT and DISABLE 
commands which each require four letters. The keyword must immediately follow the 
command character; no spaces or other characters are allowed between the command 
character and the keyword. 

The command parameters, if any, follow the keyword. The type and number of parameters 
depend on the particular command; some commands take no parameters at all. 
Parameters can be numbers, character strings, or words. A parameter word can be 
abbreviated to its first letter. 

Parameters which are characters or character strings must be separated from the 
keyword and from each other by separators. A separator can be a comma or one or more 
spaces. The separator between a numeric parameter and the keyword or between a 
numeric parameter and neighboring alphabetic parameters can be omitted. 
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The last character in a command, whether a parameter or the final character of the 
keyword, is separated from subsequent information by a command terminator. A 
terminator can be a semicolon, a carriage return, or another command character. If the 
command is the final string on a line of text, then the terminator is a carriage return. If the 
command is followed by text, a semicolon terminates the command and separates it from 
the text. If the command is followed by another command, then the command character of 
the following command can serve as the terminator. 

Figure 2-1 illustrates the format of 4027 commands. 
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Consider the following iine in Figure 2-1. 

!WOR 20 H:THIS IS THE WORKSPACEIMON H!BEL<CR> 

The ; terminates the !WOR H command. The ! of the !BEL command terminates the !MON 
H command. The <CR> terminates the !BEL command and the entire line. The string 
THIS IS THE WORKSPACE, since it is not preceded by a command character, is treated 
as text and printed in the workspace. 


Separators followed by -I- or — signs can be omitted. The command 
!RVE -l-5,0,-20,-110,+35,-110<CR> 
may be written 

!RVE-l-5,0-20-1104-35-110<CR> 

The separator between -1-5 and 0 cannot be omitted. 


Delimited ASCII Strings 

Some of the 4027 commands accept delimited ASCII strings as parameters. A delimited 
ASCII string consists of any string of printing ASCII characters with a delimiter at each 
end of the string. The delimiters mark the beginning and the end of the delimited string. 

The characters which can be used as delimiters are shown in Figure 2-2. 


{ [ ! @ ♦ $ > 

: ^ * 

( ) -(underline) 


' ' < > 

? / \ .(period) 



2402-4 


Figure 2-2. String Delimiters. 

The symboi currently used as the command character cannot be used as a delimiter. The 
hyphen (—), space, semicolon (;), and comma (,) cannot be used as delimiters (although 
their shifted versions can be used), since these symbols have special uses in 4027 
command syntax. 
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The same symbol must be used for both delimiters of a string. You may write 
ILEARNFt [iSEND MOD;[<CR> 

but not 

iLEARNFt [iSEND MOD:]<CR> 

The delimited string must not contain its own delimiter. To set the end-of-line string to the 
ASCII string ***/*, for example, we could write 

lEOL ***/* <CR>. 

Neither the * nor the / may be used here as a delimiter. 

Some commands restrict the length of a delimited string. In general, a delimited string 
should not contain the command character (except in the LEARN command). See the 
individual command descriptions for detaiis. 

Continuing a Command 

Commands typed from the keyboard may be continued to the next line by simply typing 
beyond the end of the current line and allowing the command or parameter string to “wrap 
around” to the next line. 

Some 4027 commands sent from the host require a continuation character when 
commands are continued from one line of code in the host program to the next line of 
code. This is discussed in the Host Programming for the 4027 sections. 
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THE SYNTAX OF COMMAND DESCRIPTIONS 

The 4027 command descriptions which appear in this manual use the following 
conventions: 

• The exclamation point (!) is always used as the command character. 

• In a keyword or parameter string which can be abbreviated, the necessary part of 
the string is written in uppercase; the optional part is written in lower case. For 
example, 

STOps 

means that any of the strings STO, STOP, or STOPS can be used as the keyword 
in a STOPS command. Usually the choice will be STO for efficiency or STOPS for 
readability. 

• Expressions in angle brackets, <...>, are parameter names (except the 
expression <CR>, which always means carriage return). When a command is 
given, the parameter name is replaced by one choice from a specified set of valid 
replacements. The set of valid replacements for the parameter name is listed or 
described. The DLINE command, for example, is described in this way: 

IDLIne [<count>]<CR> 

where <count> is a positive integer. 

• Optional parameters or parameter names are enclosed in square brackets. In the 
DLINE command noted above, 

[<count>] 

means that the <count> parameter may or may not be specified. Default values 
are given for all optional parameters. 
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• Whenever a list appears, with the members of the list separated by vertical bars, 
( 1 ), this means that one element is to be chosen from the list. For example, the 
FORM command syntax reads: 

IFORm [ YeslNo]<CR> 

This means that either Yes or No may be specified, but not both. Neither of these 
have to be specified. The notation Yes means that Y, YE, and YES are all valid 
parameter names and define the same command: likewise for No. Thus, 
!FOR<CR>, IFOR Y<CR>, IFORM YES<CR>, IFOR N<CR>, and IFORM 
NO<CR> are all valid commands. 

• The carriage return, <CR>, is always used as the command terminator when a 
single command is listed. In particular, in the command descriptions, <CR> 
aiways terminates the command. 


SELECTING THE COMMAND CHARACTER 

When the 4027 is shipped from the factory, it recognizes the exciamation point (1) as the 
command character. The command character can be changed by the computer or the 
operator by using the COMMAND command. The 4027 remembers its command character 
even when it is RESET or powered off. The only way to change the 4027’s command 
character is to give the COMMAND command. 

Whenever the terminal receives the command character, it tries to interpret the 
information immediately following as a command. If this information is not intended to be 
a command, confusion may result. Therefore, the command character must be selected 
with care. It should not interfere with normal printing of text or terminal/computer 
communications. 



Symbols such as carriage return, line feed, or space, which are normally 
used during communications between the 4027 and the computer, should 
NOT be used as command characters. 


The command character may vary from one applications program to another. In a text¬ 
editing program the exclamation point (1) would be a risky choice for the command 
character, since this symbol is occasionally used as a punctuation mark. Another symbol, 
perhaps # or @, should be chosen. 
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At the end of a program the command character should always be reset to the 
exclamation point. In this way, the next user will know the proper command character and 
be able to command the terminal as needed. If this has not been done, the command 
character may be found by pressing the shift STATUS key and observing the display on 
the screen. 
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COMMAND Command 

The COMMAND command is used to select a new command character. 


Syntax 

ICOMmand <character><CR> 

where <character> is a single ASCII character or a two- or three-digit ASCII Decimal 
Equivalent (ADE) of an ASCII character. 


Action 

This command sets the command character to the symbol designated by <character>. If 
<character> is a single numeral, that character is the new command character. If 
<character> is a two- or three-digit numeral, that numeral is the ADE of the new 
command character. 


Examples 


ICOMMAND 9l^<CR> Sets the command character to the number sign (#) whose 
!COM#<CR> ADE is 35. 

ICOM 35<CR> 


ICOM 8<CR> Sets the command character to the ASCII character 8. 

ICOM 08<CR> Sets the command character to the ASCII BS (backspace) 

character, whose ADE is 08. 
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HOST PROGRAMMING FOR THE 4027 


This section discusses how to use programming language statements to communicate 
with the 4027. Application programs for the 4027 can be written in any programming 
language which can display alphanumeric information on the terminal screen and accept 
data from the terminal. 

TEXT AND COMMANDS 

All information received by the 4027, whether sent from the computer or typed on the 
keyboard, can be divided into two categories: commands and text. A command causes the 
4027 to modify its internal status in some way — perhaps to select a new command 
character, to redirect text from the computer, etc. Text is information which is printed 
verbatim on the terminal screen. 

The 4027 distinguishes between text and commands by the presence of the command 
character. When the 4027 receives the command character, it assumes a command 
follows and tries to process incoming data as a command. When not processing a 
command, the 4027 treats information as text and displays it in the appropriate text 
window. 

COMPUTER-TO-4027 COMMUNICATIONS 

Any programming statement which sends alphanumeric data can be used to send text 
and commands to the 4027. Common examples are the PRINT statement in BASIC, the 
WRITE statement in FORTRAN or PASCAL, and the DISPLAY statement in COBOL. 

Suppose we are programming in BASIC. The BASIC statement 

too PRINT “IWOR 20 K” 

creates a workspace of 20 lines and directs text from the keyboard into the workspace. 
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NOTE 

When the PRINT statement is executed, the computer sends a < CR> after 
IWOR 20 K. This < CR> serves as the command terminator. 


In contrast, the BASIC statement 
200 PRINT “WOR 20 K” 

causes the text WOR 20 K to be displayed in whichever scroll receives text from the 
computer. The command character in line 100 makes the difference; it indicates to the 
4027 that the information which follows is a command. 

Suppose you wish to initialize the 4027 by establishing a 20 line workspace to receive 
text from the computer, signal the operator by printing the message THIS IS THE 
WORKSPACE in the workspace, and ring the terminal bell. The BASIC statement 

100 PRINT “IWOR 20 H KjTHIS IS THE WORKSPACEIBEL” 

causes the following events: 

• The 4027 receives the first!, signaling that a command follows. 

• The 4027 recognizes the string WOR 20 H K; as a valid command and executes it. 

• The 4027 receives the string THIS IS THE WORKSPACE. As long as the terminal 
does not see the command character, it treats incoming information as text and 
prints it in the workspace, which now receives text from the computer. 

• The 4027 receives the second !, signaling that another command follows. 

• The 4027 receives the string BEL, followed by the <CR> sent by the computer at 
the end of the PRINT statement. The 4027 recognizes the BEL<CR> as a valid 
command and executes it. 

When the 4027 receives information from the computer, it processes that information as it 
is received. Consider the example; 

100 PRINT “IWOR 20 H K;THIS IS THE WORKSPACEIBEL” 
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The 4027 executes the !WOR 20 H K; command as soon the ; is received, while 
continuing to receive information from the computer. The information THIS IS THE 
WORKSPACE, since it is not a command, is sent to the workspace as soon as the !WOR 
20 H K; command has been executed. When the terminal receives the <CR> it executes 
the !BEL<CR> command. 

In contrast to this, suppose the following line is typed on the keyboard: 

!WOR 20 H KiTHIS IS THE WORKSPACE!BEL<CR> 

No information is processed until the <CR> is typed. Then the line THIS IS THE 
WORKSPACE is displayed in the workspace. If the line came from the host it would be 
displayed in the monitor. 


Sending Numeric Parameters 

Consider the 4027 VECTOR command: 

IVEC 100,100 200,100 150,200 100,100<CR> 

In BASIC, this command can be sent to the 4027 in any of the following ways. 

1. Include the VECTOR command parameters as alphanumeric data in the PRINT 

statement: 

495 PRINT “IVEC 1 00,100 200,100 1 50,200 100,100” 

(The PRINT statement provides its own <CR>. This <CR> terminates the 
VECTOR command.) 

2. Send the VECTOR command parameters as data. 

495 PRINT “!VEC”;100,100,200,100,150,200,100,100 

3. Define, by host programming, BASIC variables XI =100, X2 = 150, X3 = 200, Y1 = 

100, and Y2 = 200. Then use the BASIC statement 

495 PRINT “!VEC”:X1 ,Y1 ,X3,Y1 ,X2,Y2,X1 ,Y1 

This method is most versatile, since the values of the variables can be modified 
by input from the 4027 operator or by the program itself. 

The 4027 graphic commands are discussed in detail in the 4027 Graphics section. 
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Continuing a Command 

Some 4027 commands can be continued from one line of code in the host program to the 
next line of code by inserting a continuation character at the end of the line. There are two 
cases where this can be done: 

• In a VECTOR, RVECTOR, PATTERN or SYMBOL command, the ampersand (&) can 
be inserted after a numeric parameter to continue the command to the next line. 
For example, the BASIC statement 

100 PRINT “IVECTOR 0,0,1 75,1 75,0,1 75,0,0” 
can be written as two lines of code: 

100 PRINT “IVECTOR 0,0,&” 

101 PRINT “175,1 75,0,1 75,0,0” 

• In a command which takes a delimited ASCII string as a parameter, the delimited 
string can be divided into two delimited strings on two consecutive lines of code 
using the hyphen (—) as a continuation character. For example, the BASIC 
statement 

200 PRINT “ILEARN FI /ISEND ALL:!ERA W/13” 
can be written as two lines of code: 

200 PRINT “ILEARN FI /ISEND ALL;/-” 

201 PRINT'VIERA W/13” 

The line of text to be continued in this way should NOT be divided between the 
command character and the keyword, within the keyword, within a numeric 
parameter, or between a number and its plus or minus sign (if the sign is present). 
Commands typed from the keyboard may be continued to the next line by simply 
typing beyond the end of the current line and allowing the command or parameter 
string to “wrap around” to the next line. 

Individual commands may tolerate minor variations in syntax. See the command 
descriptions for details. 
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A Note on Invalid Commands 

Since not all programs run correctly the first time, some information is in order concerning 
what to expect from the 4027 when it receives data which confuses it. 

When the 4027 receives an invalid command (that is, a string preceded by the command 
character but which the 4027 cannot recognize as a command), the results depend on the 
origin of this invalid command. In the following examples the command keyword STOPS is 
misspelled STEPS; 

1. Suppose the invalid command 

ISTEPS 20 40 60<CR> 

is sent from the computer in the BASIC PRINT statement 
100 PRINT “ISTEPS 20 40 60” 

The 4027 treats this invalid command as text and prints the entire string, 
ISTEPS 20 40 60, in whichever scroll receives text from the computer. 

2. When the invalid command 

ISTEPS 20 40 60<CR> 

is typed on the keyboard, an error message is printed and the invalid command 
is repeated; 

WHAT? 

ISTEPS 20 40 60 

This calls the operator’s attention to the source of the error. 
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3. Suppose this same invalid command is part of a sequence of commands sent 
from the computer as in the following BASIC statement: 

100 PRINT “lERA WISTEPS 20 40 60IBEL” 

The 4027 erases the workspace, prints the text ISTEPS 20 40 60 in whichever 
scroll receives text from the computer, and rings the bell. No error message is 
given; whatever the terminal cannot recognize as a command is treated as text. 

4. If the sequence of commands 

lERA WISTEPS 20 40 60!BEL<CR> 

is typed on the keyboard, all information preceding the invalid command is 
processed. Then an error message, the invalid command, and the remainder of 
the line are all printed in the monitor: 

WHAT? 

ISTEPS 20 40 60IBEL 

If the 4027 receives a command that requires workspace and no workspace is defined, 
the command is ignored. Nothing will be executed and no error message will appear. 
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Displaying a Command File 

How does one display a file containing 4027 commands so that it can be read, modified, 
or debugged? There are two ways this can be done: 

1. The 4027 operator can press the COMMAND LOCKOUT key and then display 
the file on the screen. When this key is lighted, the 4027 treats all information, 
including the command character, as text and prints it in the appropriate scroll 

Press COMMAND LOCKOUT (LED comes on). 


(Display file containing ! as the command 
character, review and edit this file, and 
return edited file to the computer.) 


Press COMMAND LOCKOUT again (LED goes off). 

2. The operator or the computer can change the command character to a symbol 
which does not appear in the file to be reviewed. In a file which does not contain 
the symbol #, one might have 

!COM #<CR> (Change command character to #.) 


(Display file containing ! as the command 
character, review and edit this file, and 
return edited file to the computer.) 


#COM ! (Reset command character to !.) 

The 4027 can also stay execution of commands by using the 4027 COPY command (see 
the Peripherals section). 
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4027-TO-COMPUTER COMMUNICATIONS 

There are three ways to send information from the 4027 to the computer: type into the 
monitor, use the SEND command, or use the REPORT command. 


Typing into the Monitor 

One way to enter information into the computer is to type it into the 4027 monitor. If the 
4027 is in unbuffered mode, information typed into the monitor is sent to the computer 
character by character, as it is typed. If the 4027 is in buffered mode, information typed 
into the monitor is sent to the computer line by line, as each line is terminated by a 
carriage return. Buffered and unbuffered modes are discussed in more detail in the 
System Status and Initialization section. 


SEND Command 

A second way to send information to the computer is to first enter that information in the 
4027 workspace. When the operator or the computer gives the SEND command, all the 
information in the workspace is sent to the computer. 


Syntax 

!SENd<CR> 

This command causes all information in the 4027 workspace to be sent to the computer. 

Usually the SEND key is programmed to give the SEND command, so that the operator 
can send the workspace contents to the computer, simply by pressing the SEND key at 
the appropriate time. 

The SEND command is used in conjunction with whatever input request statement is 
available in the programming language. In BASIC, for example, the INPUT statement is 
used; in COBOL, the ACCEPT statement is used. 


NOTE 

The key labeled SEND on the 4027 keyboard Is NOT pre-programmed. It 
may be programmed to give the SEND command using the LEARN 
command or the LEARN key. 
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The following program asks the operator to type a one-line message in the workspace and 
press a key to send this message to the computer. When the computer receives the 
message, it prints it back in the monitor, so that the operator can verify the message was 
correctly received. 


LIST 

NONPME 09:09 AM 25-Apr-78 

100 REM—CREATE A aEAN WORKSPACE 
110 PRINT '!W0R 20 K' 

120 REM-PROGRAM SEND KEY (FUNCTION KEY 8) TO GIVE I SEND COMMAND 

130 PRINT 'ILEA F8/1SEND/13 10' 

140 REM—INFORM OPERATOR 
150 PRINT 'IMON H' 

160 PRINT 'This program accepts a message from the 4027 Workspace' 

161 PRINT 'and verifies the message u)as received. When you type your' 

162 PRINT 'message, it appears in the workspace. When you press the’ 

163 PRINT 'SEND key, your ntessage is sent to the computer. The corriputer' 

164 PRINT 'verifies your message by printing it back to you, in the' 

165 PRINT 'monitor. Now type your message and press the SEND key when' 

166 PRINT 'ready.' 

200 REM—ACCEPT INPUT FROM TERMINAL 
210 INPUT A$ 

220 REM—SEND ItSSAGE RECEIVED BACK TO TERMINAL 
230 PRINT 'Your message was received. It read:' 

240 PRINT 
250 PRINT A$ 

260 PRINT 
270 PRINT 
999 END 
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NOW IS THE TIME 


This pro 9 ram accepts a message from the 4027 Workspace 
and verifies the message uias received. When you type your 
message, it appears in the workspace. When you press the 
SEND key, your message is sent to the computer. The computer 
verifies your message by printing it back to you, in the 
monitor. Now type your message and press the SEND key when 
ready. 

? 

Your message was received. It read: 

NOW IS THE TIME 

2657-3 


NOTE 

When the SEND command is given from the computer, it must be pieced in 
the applications program before the input request statement. In BASIC, for 
example, write 

100 PRINT "iSEND” 

110 INPUT A$ 

Do not write 

200 INPUT A$ 

210 PRINT “ISEND” 

In the latter case, the program never executes line 210. It halts at line 200, 
waiting for data which never comes. 


The use of the SEND command in form fillout applications is discussed in the Forms and 
Form Fillout section. 
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REPORT Command 

A third way to send information to the computer is for the computer to issue the REPORT 
command to the 4027. 


Syntax 

IREPort <device><CR> 
where <device> is an integer from 00 to 14. 


Action 

This command causes the 4027 to send a report to the computer. The report has the 
foiiowing format: 

IANS <device>,<datafield>; 

The report identifier ANS (for “answer”) is foliowed by one space, the two-digit <device> 
number, then a comma, then the <data field>, and finaliy a semicoion. 

The <data field> parameter contains one or more fieids, separated from each other by 
commas. The format of <data fieid> depends on the value of <device>: that is, on the 
device reporting. For a given device, however, the format of <data field > is always the 
same. This allows the applications program to correctly extract data from <data field>, 
knowing which device was interrogated. 


Examples 

1. The command 

!REP 00<CR> 

causes the 4027 to report the system status block to the computer. This report 
is in the following format: 

IANS 00,<p1>,<p2>: 
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where 

<p1 > is a four-digit decimal number specifying the number of unused blocks 
of memory. (A block consists of 16 8-bit bytes.) 

<p2> is a three-digit number representing the decimal equivalent of a binary 
number which specifies the system status byte. The numbers which may be 
displayed and the condition they represent are; 


004 — monitor present (always true). 

005 — monitor present, buffered mode. 

006 — monitor present, form fillout mode. 

007 — monitor present, form fillout mode, buffered mode. 

2. The command 

!REP01<CR> 

causes the 4027 to report the status of the alpha cursor within the workspace 
to the computer. If no workspace is present, all zeros are returned. This report is 
in the following format: 

IANS 01,<p1 >,<p2>,<p3>: 

where 

<p1 > is a three-digit decimal number specifying the row of the workspace in 
which the cursor is located. 

<p2> is a three-digit decimal number specifying the column of the workspace 
in which the cursor is located. 

<p3> is a single character, the character displayed at the cursor position. 
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3. The command 

!REP 02 <CR> 

causes the 4027 to report the position, color, and shrink factor of the graphic 
beam. This report is in the following format: 

IANS 02,<data 1 >, <data 2>, <data 3>, <data 4>; 

where 

<data 1 > is a three-digit decimal number which indicates the current x- 
coordinate of the graphic beam position. 

<data 2> is a three-digit decimai number which indicates the current y- 
coordinate of the graphic beam position. 

<data 3> is a three-digit decimai number preceded by C or P which indicates 
the current color (C0-C7) or pattern number (P0-P119). 

<data 4> is a three-digit number indicating the current shrink factor. The 
number may be: 

001 = 4010 

002 = hardcopy 

003 = both 4010 and hardcopy 


NOTE 

Hardcopy shrinking is not necessary on the 402 7, but is inciuded for 4025 
compatibiiity. 
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4. The command 

!REP 03<CR> 

Causes the 4027 to report the status of the crosshair; whether it is present and 
its position. This report is in the following format: 

IANS 03, <data 1 >, <data 2>, <data 3>; 

where 

<data 1 > is a three-digit decimal number that indicates whether the crosshair 
is visible (000 is off, 001 is on, 002 is on in 4010 mode). 

<data 2> is a three-digit decimal number that indicates the current x- 
coordinate of the crosshair. 

<data 3> is a three-digit decimal number that indicates the current y- 
coordinate of the crosshair. 

The REPORT command can be used for purposes other than straightforward interrogation 
of the system status block, the workspace cursor, graphic beam information and 
crosshair positioning. 

As an example, suppose the applications program is sending large amounts of data to the 
4027 at relatively high baud rates. It is possible for the computer to overrun the 4027’s 
input buffer, resulting in loss of information. Occasionally inserting the pair of statements 
(here in BASIC) 

XXX PRINT “!REP 00” 

XXX-HI INPUT A$ 

causes the program to pause at each input statement and not continue until it receives 
input for A$ (that is, until the 4027 has processed its entire input buffer and ANSwers the 
REPort command). This prevents the program from sending more data to the terminal until 
the terminal has processed its input buffer. What the terminal ANSwers is not important, 
only that it ANSwers. 
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The REPORT command is also used to obtain information about peripherals which may be 
attached to the 4027. Details are contained in the Peripherals section. Appendix E 
contains a program segment in PASCAL to illustrate how the input from a REPORT 
command can be processed. 

Listed below is a summary of the REPORT command <device> numbers and the devices 
they reference. 


Device number: Reports: 

00.system status block 

01.alpha cursor information 

02.graphic beam information 

03.crosshair information 

04.tape unit 1 

05.tape unit 2 

06.tape unit 3 

07.tape unit 4 

08.reserved 

09.reserved 

10 .reserved 

11 .reserved 

12 .plotter 1 

13 .plotter 2 

14 .printer 
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Section 4 


PROGRAMMING THE KEYBOARD 


The 4027 keyboard is programmable; that is, most of the keys can be programmed to 
generate a character or string of characters other than the default ones. When a key is 
programmed, the new definition assigned to that key is stored in the 4027 RAM (Random 
Access Memory). If the terminal is RESET or powered off, the definition is lost and the key 
reverts to its default definition. 

Key programming enabies the operator to give a command or sequence of commands by 
pressing a single key. During an applications program the operator can log on or log off 
the computer, change terminal parameters, send Information to the computer, page 
through text, or perform any of several convenient functions just by pressing a key. Key 
definitions may be part of terminal initialization or may occur at convenient points in a 
program. A key can have several different definitions in a single program. 

The user can also use the LEARN command to define sixteen macros (M1 -M16). Macros 
are command or text strings defined in the same way as programmed keys. However, a 
macro is not executed by depressing any key. Instead, a macro is executed when the 
EXPAND command is received from the host computer or the keyboard. 

All the keys on the 4027 keyboard can be programmed except the following six keys: 

• The rightmost three lighted function keys - TTY LOCK, NUMERIC LOCK/LEARN, 
and COMMAND LOCKOUT/STATUS. (Neither the shifted nor the unshifted 
versions of these keys can be programmed.) 

• The SHIFT, CTRL, and BREAK keys. 


PROGRAMMING A KEY 

A key may be programmed with a new definition in one of two ways: 

• The operator may use the LEARN key. 

• The operator or computer may give the LEARN command. 

The LEARN key performs the same action as the LEARN command. The 4027 Operator’s 
Manual describes the use of the LEARN key. 
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LEARN Command 


Syntax 

ILEArn <key> [<string>]<CR> 
where 

<key> designates the key or macro to be programmed. 

<string> designates the character or character string to be assigned to the 
designated key. 

Action 

This command redefines the key or macro designated by the <key> parameter; 
whenever this key is pressed or macro called, it generates the character string defined by 
<string>. 


Range of Parameters 


The <key> parameter may be any of the following; 


• A single printing ASCII character. 

e A two- or three-digit ADE (ASCII Decimal Equivalent) value from 00 through 127, 
inclusive. (See the ASCII Code Chart Appendix B.) 

• A mnemonic representing a non-ASCII key (function key or cursor/numeric pad 
key): 


F1 - F12 
S1 - S12 

PO - P9, P., PT 


Function keys 1 through 12 

Function keys 1 through 12 with SHIFT 

depressed 

Numeric pad keys and Pad Terminator key 


• Ml - M16 


Internal macros 1 through 16 set by giving 
the LEARN command from keyboard or host. 
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• A “psuedo-ADE value” representing a non-ASCII key: 


128 

Function Key 

1 

129 

Function Key 

2 

130 

Function Key 

3 

131 

Function Key 

4 

132 

Function Key 

5 

133 

Function Key 

6 

134 

Function Key 

7 

135 

Function Key 

8 

136 

Function Key 

9 

137 

Function Key 

10 

138 

Function Key 

11 

139 

Function Key 

12 

140 

Function Key 

13 

160 

Pad Key 0 


161 

Pad Key 1 


162 

Pad Key 2 


163 

Pad Key 3 


164 

Pad Key 4 


165 

Pad Key 5 


166 

Pad Key 6 


167 

Pad Key 7 


168 

Pad Key 8 


169 

Pad Key 9 


170 

Pad Key. 


171 

Pad Terminator Key 


144SHIFT-FunctionKey 1 

145 SHIFT-Function Key 2 

146 SHIFT-Function Key 3 

147 SHIFT-Function Key 4 

148 SHIFT-Function Key 5 

149 SHIFT-Function Key 6 

150 SHIFT-Function Key 7 

151 SHIFT-Function Key 8 

152 SHIFT-Function Key 9 

153 SHIFT-Function Key 10 

154 SHIFT-Function Key 11 

155 SHIFT-Function Key 12 

156 SHIFT-Function Key 13 

172 ERASE 

173 SHIFT-ERASE 

174 BK TAB 


The <string> parameter may be any of the following: 

• One or more ADE values 

• One or more pseudo-ADE values 

• One or more delimited ASCII strings 

• Any combination of the above 

If the <string> parameter is omitted, the key is assigned its default meaning (the 
standard keyboard meaning). The <string> parameter may be any length as long as the 
terminal’s display memory capacity is not exceeded. 
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Examples 

Redefines the # key (SHIFT-3 key), whose 
ADE is 35, to generate the parentheticai 
comment (End-of-Page). The definition of the 
3 key is unchanged. 

!LEA 35 13<CR> Redefines the # key to mean carriage 

return. 

!LEA F8 “iSEND MOD;”13<CR> Programs function key F8, whose pseudo- 

!LEA 135 “ISEND MOD:”13<CR> ADE is 135, to give the ISEND MOD com¬ 

mand. 

ILEA 148 /IWORIERA W:READY FOR NEXT PROGRAM/ 7 7 7 /IMON;/13<CR> 

Programs the SHIFT-HOME key, whose 
pseudo-ADE is 148, to direct text from the 
keyboard into the workspace, erase the 
workspace, print the message READY FOR 
NEXT PROGRAM there, ring the terminal bell 
three times, and return the keyboard to the 
monitor. 

ILEA 148<CR> Restores the SHIFT-HOME key to its defauit 

meaning (undefined). 

ILEA Ml/The rain in Spain faiis mainly on the plain./<CR> 

Programs macro Ml to print the delimited 
string. Ml may be invoked by giving the 
EXPAND Ml command from the keyboard or 
the host computer. 

ILEAM16/IRVE 0,0 20,0 0,100 -10,-50/13 <CR> 

Defines macro Ml 6 to be the specified RVEC- 
TOR command. 

ILEA F1/IRMAP 02 30,-25,-50/13 <CR> 

ILEA 128/IRMAP 02 30,-25,-50/ 13 <OR> 


ILEARN * /(End-of-Page)/<OR> 
ILEA 35 /(End-of-Page)/<OR> 
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NOTE 

When programming a key to give a command or sequence of commands, 
aiways inciude the ADE 13 as the test character of < string> (outside the 
delimiters). This insures that pressing the programmed key causes the 
command(s) to be executed. 

Special Considerations 

When the LEARN command is given from the computer, it may be continued from one iine 
of program code to the next by using a hyphen (—) as a continuation character. This 
causes the next <CR>, up to one <LF>, and ail NULs, RUBOUTs, and SYNCs to be 
ignored until another character is received. The LEARN command 

ILEA F3 /THIS COMMAND IS TOO LONG TO FIT ON ONE LINE./ 13<CR> 

can be written on two consecutive lines of BASIC program code as follows: 

100 PRINT “ILEA F3 /THIS COMMAND IS TOO /-” 

101 PRINT “/LONG TO FIT ON ONE LINE./ 13” 

This does not apply to a LEARN command entered from the keyboard. If the command is 
entered from the keyboard, one simply continues typing until the command is complete. If 
the command is longer than one line (80 characters), the cursor wraps around to the next 
line; the command is not terminated until <CR> is pressed. 

Since delimited strings may contain only printing ASCII characters, any control 
characters or non-ASCII characters included in a LEARN command must be encoded 
using ADEs or pseudo-ADEs outside the delimited string. Thus, the command 

!LEA$ 13 10<CR> 

programs the $ key (SHIFT-4 key) to mean <CR><LF>. In contrast, the command 
!LEA$/13 10/<CR> 

programs the $ key to print the ASCII string 13 10. 

If one of the ASCII numeral keys (0-9) or the period key ( . ) is programmed, the 
corresponding numeric pad key (with the NUMERIC LOCK key lighted) is also 
programmed. Likewise, if the numeric pad key (with NUMERIC LOCK on) is programmed, 
the corresponding ASCII numeral or period key is programmed. Programming an ASCII 
key does not program the corresponding cursor pad key with NUMERIC LOCK off. 
Likewise, programming the cursor pad key with NUMERIC LOCK off does not program the 
ASCII key marked with the same symbol. 
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If the character string assigned to a programmed key includes one or more commands, 
those commands are executed but not displayed on the screen when the programmed key 
Is pressed. 

The <string> parameter may include the CLEAR command, discussed later in this 
section. Suppose we program the F1 function key as follows: 

ILEARN FI /lERA M!CLEAR!BEL:Goodbye for now.!MON/13<CR>. 

Pressing Ft causes all of the commands to be executed and the text “Goodbye for now.” 
to be printed in the workspace, even though the CLEAR command is given early in this 
string. The string will be executed only the first time the key is pressed. 


Function key pseudo-ADE’s can be included in the <string> parameter, but those ADE’s 
generate default definitions instead of previously programmed definitions. Consider the 
command sequence: 

ILEARN 1 72 /lERA WIBEL/13<CR> 

ILEARN 128 172<CR> 

The first LEARN command programs the ERASE key (pseudo-ADE 172) to erase the 
workspace and ring the beil. the second LEARN comand programs function key FI to 
mean the same as the unprogrammed ERASE key. 


NOTE 

The SEND keys (keys F8 and S8, with pseudo-ADEs 135 and 151, 
respectively) have no meaning until programmed. Normally, these keys will 
be programmed to give the SEND ALL or SEND MOD command, or some 
command sequence which sends information to the computer. 


Macros and the EXPAND Command 

The EXPAND command is used to execute macros which were defined by the LEARN 
command. 
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EXPAND Command 

Syntax 

lEXPand <macro no.><CR> 
where <macro no.> is a macro name (M1, M2, . . . , M16). 


Action 

This command is used to invoke any macros specified by the LEARN command. EXPAND 
may be given by the keyboard or the host computer. Thus, a command or series of 
commands or a string may be sent by the host or the operator by giving the EXPAND 
command. 


Example 

lEXPand M1 <CR> 

causes the string assigned to the given macro (M1) to be inserted in the input queue in 
place of the EXPAND command. Macros are numbered M1 through M16. 


The LEARN Command and the COMMAND Command 

Do not confuse programming a key using the LEARN command and selecting a new 
command character using the COMMAND command. These operations are different. 

Programming a key with the LEARN command causes the programmed key to generate a 
different character or character string than it normally generates. In contrast to this, 
selecting a new command character does not change the character string generated by 
any key. Rather, it changes the way the 4027 processes the default symbol generated by 
one particuir key. The same key generates the same symbol, but that symbol, when seen 
by the terminal, now has a different effect. 

When the COMMAND command selects a new command character for the 4027, this new 
selection is stored in the 4027 battery-maintained RAM. This means that the 4027 
remembers the new command character, even when it is turned off or RESET. The only 
way to change the 4027’s command character is to give a new COMMAND command. 
When a key is programmed using the LEARN command, however, the learned definition is 
lost if the terminal is turned off or RESET, and the key returns to its default definition. 
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KEY PROGRAMMING AND KEYBOARD LOCKOUT 

When a key is programmed, the new definition assigned to that key is generated 
whenever the key is pressed; however, the default character assigned to that key can still 
be sent to the terminal. It is not the default character, but the key itself, which generates 
the new definition. 

Suppose we execute the following sequence of commands: 

ILEA 1 27 34ILEA 34 /IWOR 20 H K/13<CR> 

The RUBOUT key (ADE 127) is now programmed to mean quotes (“) and the quotes key 
(ADE 34) is programmed to mean IWOR 20 H K<CR>. The ASCII quotes character can 
be sent to the terminal with its usual meaning, either by sending the ASCII quotes 
character (ADE 34) from the computer or by pressing the RUBOUT key on the keyboard. 

It may be desirable to prevent an operator from issuing arbitrary commands to the 
terminal during an applications program, but still allow him to issue certain specific 
commands or command sequences. During a form fillout program for example, the 
operator should not be able to modify the form itself, but should be able to give the SEND 
MOD command. 

Key programming can accomplish this. Suppose I is the command character. If the 
computer sends the command 

ILEARN 33 00<CR> 

to the 4027, the I (SHIFT-1) key is programmed to generate the ASCII NUL character. This 
prevents the operator from using the I key to generate the command character. Yet the 
computer can send command characters to the terminal and can program function keys 
to issue commands when pressed by the operator. Only the operator’s ability to issue the 
command character arbitrarily from the keyboard is impaired. At the proper time, the 
computer returns control of the 4027 to the keyboard by sending the command 

ILEARN 33<CR> 

This returns the ! key to its default meaning. 
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CLEARING KEY DEFINITIONS 

To restore a single key to its default definition or to clear macro definition, use the LEARN 
command with the <string> parameter omitted. The command 

ILEARN <key><CR> 

will restore the <key> key or macro to its default meaning. 


CLEAR Command 

To clear all programmed key definitions and all macro definitions simultaneously, use the 
CLEAR command. 

The command 

!CLEar<CR> 

clears all key and macro definitions generated by LEARN commands or by the LEARN 
key. All keys revert to their default definitions; all macros become undefined. 
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Section 5 


SYSTEM STATUS AND INITIALIZATION 


The 4027 has many operating parameters which can be set from the keyboard or from the 
computer. This aliows the 4027 to interface with a variety of host systems, as well as run 
many different applications programs easily and effectively. Some of these parameters 
(the end-of-line string, for example) must be set when the terminal is first installed and 
are changed infrequently, if at all. Other parameters (the form fillout mode setting, for 
example) will be changed more often, perhaps several times within the same program. 

Clearly, it is necessary for the host and the applications program to be well informed of 
the status of these parameters. Since these settings may be changed from the keyboard 
without the host’s knowledge, the first task of any applications program is to initialize the 
terminal; that is, the terminal must be set to a known and desired state which facilitates 
execution of the program. When the program is completed, the terminal should be 
returned to a known reference state for the convenience of future users. 

Some parameters affect the status of the terminal itself. Other parameters affect the 
status of communications between the terminal and the host computer. This section first 
discusses the terminal status commands which determine the status of the terminal itself. 
These are the COMMAND, WORKSPACE, MONITOR, MARGINS, STOPS, FORM, and 
SNOOPY commands. Then the communication status commands which determine the 
status of communications between the 4027 and the host computer are discussed. These 
are the BAUD, PARITY, ECHO, BUFFERED, EOL, PROMPT, DELAY, FIELD, EOF, DUPLEX, 
and DISCONNECT commands. 
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TERMINAL STATUS COMMANDS 

COMMAND Command 

The syntax of the COMMAND command is 
iCOMmand <character><CR> 


where <character> is a single printing ASCII character or the ADE (ASCII Decimal 
Equivalent) of an ASCII character. The syntax and action of this command were 
discussed in the 4027 Command Structure section; however, some additional comments 
regarding terminal initialization are in order here. 


Since each command to the 4027 must be preceded by the command character, the 
computer must know the command character at all times. Although the terminal operator 
can discover the command character by pressing the STATUS (SHIFT-COMMAND 
LOCKOUT) key, the computer cannot do this. Therefore, at the end of each applications 
program the command character must be set to a reference symbol. This insures the next 
user proper access to the terminal. The exclamation point (!) is recommended as the 
reference symbol. It is the command character when the 4027 is shipped from the factory. 
It is also used as the command character throughout this manual and throughout the 
4027 Operator’s Manual. 


The command character can be changed at the beginning of an applications program, or 
anytime during the program, by using the COMMAND command. But the program should 
always reset the command character to the reference character, I, before releasing 
control of the terminal. Consider a text-editing program. Since the I symbol is used 
occasionally as a punctuation mark, one may wish to avoid using it as the command 
character in this situation. Such a program might begin by choosing another command 
character, say the @ character, and resetting to I at the end of the program: 

ICOM @<CR> 

(Body of program) 

@COM !<CR> 

End of execution 
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WORKSPACE Command 


When the 4027 is powered up or RESET, there is no workspace or workspace window, the 
entire 34-line screen is devoted to the monitor window, and text from both the keyboard 
and the computer is directed into the monitor. Before an applications program is run, the 
4027 terminal screen must be initialized: 


• Divide the screen into a workspace window and a monitor window to display 
information from the corresponding scrolls. 

• Direct text from the computer and from the keyboard into the appropriate scrolls. 


One of the commands used to initialize the screen is the WORKSPACE command. 


Syntax 


IWORkspace [<number>] [ Host ] [ Keyboard ]<CR> 
where <number> is an integer between 0 and 33, inclusive. 


Action 


If <number> is included, this command erases the entire display list (the monitor, and if 
a workspace is defined, the workspace also). The terminal then defines a workspace and 
allots the top <number> lines of the screen for the workspace window. The remaining 
34-<number> lines are used for the monitor window. At least one line is always reserved 
for the monitor window. 

If H (Host) is specified, text from the host computer is directed into the workspace. If K 
(Keyboard) is specified, text from the keyboard is directed into the workspace. 
(Commands typed on the keyboard are still displayed in the monitor.) 
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If only the <number> parameter is specified, text from the keyboard and text from the 
computer go to the same scrolls as before. A WORKSPACE 0 command directs text from 
both the keyboard and the computer into the monitor, since this command destroys the 
workspace. 


if no parameters are specified, and the command comes from the host computer, a 
WORKSPACE H command is executed. If no parameters are specified and the command 
is typed on the keyboard, a WORKSPACE K command is executed. 


Examples 

IWOR 20 H K<CR> 


IWOR 25<CR> 


IWOR 0<CR> 


IWOR H<CR> 


IWOR<CR> 


Erases the display list, reserves the top 20 lines of the 
screen for the workspace window, and directs text 
from both the computer and the keyboard into the 
workspace. 

Erases the display list, reserves the top 25 lines of the 
screen for the workspace window. Does not change 
the destination of text from the computer or of text 
from the keyboard. 

Erases the dispiay list, reserves the entire 34-line 
screen for the monitor window. Directs text from both 
the computer and the keyboard into the monitor, since 
no workspace is defined. 

Directs text from the computer into the workspace. 
Does not erase the workspace or change the position 
of the workspace cursor. 

If this command comes from the computer, it directs 
text from the computer into the workspace. If the 
command comes from the keyboard, it directs text 
from the keyboard into the workspace. 
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MONITOR Command 

The WORKSPACE command does not allow you to specify which devices (Host, 

Keyboard) send information to the monitor. The MONITOR command allows you to do this, 
as well as create text windows. 


Syntax 

IMONitor [<number>l [Host] [ Keyboard ]<CR> 
where <number> is an integer between 1 and 34, inclusive. 


Action 

If <number> is included, this command erases the entire dispiay list (the monitor, and if 
a workspace is defined, the workspace also). The terminal then defines a workspace and 
reserves the top 34-<number> lines of the screen for the workspace window. The 
remaining <number> lines are used for the monitor window. At least one line is always 
reserved for the monitor window. 

If H (Host) is specified, text from the computer is directed into the monitor. If K (Keyboard) 
is specified, text from the keyboard is directed into the monitor. 

If <number> is the only parameter specified, text from the computer and from the 
keyboard go into the same scrolls as before. A MONITOR 34 command directs text from 
both the computer and the keyboard into the monitor, since this command destroys the 
workspace. 

If no parameters are specified and the MONITOR command comes from the host 
computer, a MONITOR H command is executed. If no parameters are specified and the 
MONITOR command is typed on the keyboard, a MONITOR K command is executed. 


Examples 

!MON 10 H K<CR> Erases the display list, creates a monitor window of 10 

lines and a workspace window of 24 lines, and directs 
text from the computer and from the keyboard into the 
monitor. 
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!MON 4<CR> 

!MON 34<CR> 

!MON H<CR> 

!MON<CR> 


Erases the display list, creates a monitor window of 4 
lines and a workspace window of 30 lines. Text from 
the keyboard and text from the computer go into the 
same scrolls as before. 

Erases the display list and reserves the entire 34 lines 
of screen for the monitor window. Directs text from 
both the computer and the keyboard into the monitor, 
since no workspace is defined. Equivalent to a WORK¬ 
SPACE 0 command. 

Directs text from the computer into the monitor; does 
not erase either scroll. 

If this command comes from the computer, it directs 
text from the computer into the monitor. If the com¬ 
mand comes from the keyboard, it directs text from the 
keyboard into the monitor. 
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MARGINS Command 

Workspace margins are set with the MARGINS command. (Monitor margins are always 
set to columns 1 and 80, and cannot be changed.) 


Syntax 

IMARgins [<left>] [<right>]<CR> 

where <left> and <right> are integers between 1 and 80, inclusive, and <left> is less 
than <right>. If only one parameter is specified, it is taken to be the <left> parameter; 
in this case, the <right> parameter remains unchanged. If both parameters are omitted, 
<left> and <right> default to 1 and 80, respectively. 


Action 

This command sets the workspace margins — the left margin to column <left> and the 
right margin to column <right>. 


When the terminal receives a <CR> from the computer or from the keyboard, the cursor 
moves to column <left>. All cursor movement keys and almost all commands which 
move the cursor respect the left margin: if the left cursor key is pressed repeatedly, the 
cursor moves left to column <left>, then wraps around to column 80 of the previous line; 
the BACKTAB key does not move the cursor past column <left>. (The one exception is 
the JUMP command. See the Controlling the Display section.) 


If a character is typed into column <right>, the terminal bell rings. This is the only action 
which occurs. If more characters are entered in the workspace, those characters are 
displayed on the same line, and the cursor continues moving right until either (1) the 
cursor moves past column 80 and wraps around to the next line, or (2) the terminal 
receives a <CR> as a signal to begin a new line. In either case, the cursor moves to the 
left margin in column <left> of the next line. 


Examples 

IMARGINS 10 70<CR> Sets the left workspace margin to column 10 and the 

right margin to column 70. 
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!MAR 25<CR> Sets the left margin to column 25; leaves the right 

margin unchanged. 

!MAR<CR> Sets the left and right margins to their default settings: 

columns 1 and 80, respectively. 


The 4027 remembers its right and left margins when it is powered off or RESET. 

NOTE 

Unless stated otherwise, it is always assumed in this manual that the left 
margin is set to column 1. 
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STOPS Command 

Tab stops are set with the STOPS command. 


Syntax 

ISTOps [<stop 1 >] [<stop 2>]... [<stop 16>]<CR> 

where each <stop n> parameter is a positive integer between 2 and 80, inclusive, and 
parameters are arranged in increasing order. 


Action 

This command sets up to 16 tab stops by listing the columns in which stops are defined. 
Stops are defined in both the workspace and the monitor simultaneously. Only the stops 
specified are defined; all previous stops are deleted. Stops may be set to the left of the 
left workspace margin, to the right of the right workspace margin, and between the 
margins. 

If no parameters are specified, all tab stops are cleared. 


Examples 

!STO 10 20 35 45 60<CR> Defines monitor and workspace tab 

stops in columns 10, 20, 35, 45, and 60. No other 
stops are defined: any previously defined stops are 
deleted. 

!STO<CR> Clears all tab stops. 

The 4027 remembers its tab stops when powered off or RESET. 
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FORM Command 

The FORM command places the 4027 in form fillout mode and removes it from form fillout 
mode. 


Syntax 

iFORm [ Yes|No]<CR> 


Action 

The FORM YES command (or equivalent) places the 4027 in form fillout mode. The FORM 
NO command (or equivalent) removes the 4027 from form fillout mode. A detailed 
discussion of form fillout mode is found in the Forms and Form Fillout section. 

If no parameter is specified, Y (Yes) is assumed. 


Examples 

IFORM YES<CR> Places the 4027 in form fillout mode. 

IFOR Y<CR> 

!FOR<CR> 

IFORM NO<CR> Removes the 4027 from form fillout mode. 

IFOR N<CR> 


The 4027 always powers up and RESETS to FORM NO. 
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SNOOPY Command 

The 4027 has a “snoopy” mode of operation. In snoopy mode, the non-printing ASCII 
characters (control characters) are represented on the screen by two letter mnemonics. 
The RUBOUT (or DELETE) character is represented by a blotch of fine diagonal lines. 
Entering and leaving snoopy mode is controiled by the the SNOOPY command. 


Syntax 

ISNOopy [ Yes I No ] < CR > 

If neither parameter is specified, Yes is assumed. 


Action 

The SNOOPY YES command places the 4027 in snoopy mode. The SNOOPY NO 
command removes the 4027 from snoopy mode. 

Snoopy mode is useful for troubleshooting and debugging, since it allows the operator to 
examine all ASCII characters received by the terminal, not just printed characters. It is 
also useful for inserting control characters into text stored in the workspace. Commands 
are still executed in snoopy mode. 

To see the ASCII NUL character printed when examining incoming data, it is necessary to 
have the 4027 parity set to “data.” (See the discussion of the PARITY command in this 
section.) 


Examples 

ISNOOPY YES<CR> Places the 4027 in snoopy mode. 

ISNO Y<CR> 

!SNO<CR> 

ISNOOPY NO<CR> Removes the 4027 from snoopy mode. 

ISNON<CR> 


The 4027 always powers on or RESETS to SNOOPY NO. 


@ 


4027 PROGRAMMER’S 


5-11 



STATUS/INITIALIZATION 

SNOOPY COMMAND 


Table 5-1 


SNOOPY MODE MNEMONICS 


CONTROL 

CHARACTER 

SNOOPY MODE 
MNEMONIC 

CONTROL 

CHARACTER 

SNOOPY MODE 
MNEMONIC 

NUL 


DLE 


SOH 


DCl 


STX 


DC2 


ETX 


DCS 


EOT 


DC4 

‘il 

ENQ 


NAK 


ACK 

'V 

SYN 


BEL 


ETB 


BS 


cm 


HT 

»v 

EM 


LF 


SUB 

% 

VT 


ESC 


FF 


FS 


CR 


GS 


SO 


RS 


SI 

h 

US 
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COMMUNICATIONS STATUS COMMANDS 


BAUD Command 

The simplest communications system consists of a device to transmit information, a 
device to receive information, and a communications link or “line.” The rate at which 
information is transferred over a communications line is called the “baud rate.” This rate 
is given in bits/second; a baud rate of 1200 means information is transferred at the rate 
of 1200 bits/second. 

During any communication, the rate at which the transmitting device transmits information 
must be the same as the rate at which the receiving device receives it. If the host 
computer is sent data to the 4027 at 1200 baud, the 4027 must be set to receive data at 
1200 baud or greater. 

The 4027 has a “receive baud rate” and a “transmit baud rate.” These need not be the 
same; i.e., the terminal may receive information at a different rate than it transmits 
information. 

The 4027 baud rates are set using the BAUD command. 


Syntax 

IBAUd <transmit>[<receive>]<CR> 
where both <transmit> and <receive> are chosen from the following list: 

(0 I 50 I 75 I 110 I 134 I 150 I 300 I 600 I 1 200 I 1800 | 2400 | 4800 | 9600) 

Action 

This command sets the transmit baud rate to <transmit> and the receive baud rate to 
< receive>. A baud rate of 0 means a “times 1” external clock is used. 

If <receive> is omitted, it is set equal to <transmit>. 
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Examples 

!BAU 300,1200<CR> Sets the transmit baud rate to 300 baud and the 

receive baud rate to 1200 baud. 

!BAU 2400<CR> Sets both transmit and receive baud rates to 2400 

baud. 

When the 4027 is turned off or RESET, it remembers the current baud rate. 
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PARITY Command 

In the ASCII code, each of the 128 ASCII characters is represented by a 7-bit binary 
number. When a character is transmitted, an eighth bit, called a “parity bit,” is also 
transmitted. Some computers use this extra bit for error checking, some use it as a data 
bit, and some simply ignore it. 

The 4027 parity must be set to correspond with that of the computer to which it is 
connected. This is done by using the PARITY command. 


Syntax 

IPARity [ Even | Odd | None | High | Data ]<CR> 

If no parameter is specified, the 4027 parity defaults to None. 


Action 

This command sets the 4027 parity. If the parity is set to Even, the terminal transmits 
characters with even parity and checks incoming characters for even parity. If the parity 
is set to Odd, the terminal transmits characters with odd parity and checks incoming 
characters for odd parity. If the parity is set to None, the terminal transmits characters 
with parity bit set to zero; the parity of characters input to the terminal is ignored. If the 
parity is set to High, the terminal transmits characters with parity bit set to one; the parity 
of incoming characters is ignored. If the parity is set to Data, the parity bit of each 
character input to the terminal is treated as data; the parity bit is set to zero on characters 
output from the terminal. Note that with parity set to data, if a character is received which 
has the parity bit set to one, it will be treated as a pseudo-ADE rather than a real ASCII 
character (since real ASCII is in the range of 0 to 127). Thus a parity setting of data 
should only be used if the programmer can control how the computer sets the parity bit. 


Examples 


!PAR 

IPAR 

IPAR 


E<CR> 

Sets the 4027 to even parity. 

0<CR> 

Sets the 4027 to odd parity. 

N<CR> 

Sets parity to “none;” the 4027 ignores the parity bit 
on input characters and sets it to zero on output 
characters. 


@ 


4027 PROGRAMMER’S 


5-15 



STATUS/INITIALIZATION 

PARITY COMMAND 


!PAR H<CR> Sets parity to “high;” the 4027 ignores the parity bit on 

input characters and sets it to one on output charac¬ 
ters. 

!PAR D<CR> Sets parity to “data;” the parity bit is read as a data bit 

for incoming characters and set to zero on output 
characters. 

The 4027 remembers its parity setting when powered off or RESET. 
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ECHO Command 

When the operator types into the monitor in unbuffered mode, there are two ways that the 
characters typed may be displayed on the screen: remote echo and local echo. 

In remote echo communications, characters typed into the monitor are sent to the 
computer without being displayed. As the computer receives each character, it “echoes” 
it back to the terminal. (In some systems, a modem may provide the echo.) It is the 
received echo, rather than the original transmitted character, that the 4027 displays on 
the screen. In remote echo communications: 

• As each character is typed into the monitor, the operator can tell immediately 
whether the computer has received that character correctly. 

• Selective echo is possible. The computer can be programmed to decide which 
characters to echo. In timesharing systems, for example, the computer is usually 
programmed not to echo a user’s password. 

In local echo communications, as each character is typed into the monitor, the 4027 
supplies its own echo. It displays each character sent to the computer without waiting for 
the computer echo. Local echo communications may be used with half duplex 
communications links, while remote echo requires full duplex communications. 

It is important that the 4027 be set for the proper echo. If the 4027 is set to remote echo 
and neither the host nor the modem provides an echo, characters typed on the keyboard 
are not displayed at all. If the 4027 is set to iocai echo and either the host or the modem 
also provides an echo, characters typed in the keyboard are displayed twice. 

The type of echoing which the 4027 uses is selected with the ECHO command. 


Syntax 

lECHo [Local I Remote]<CR> 

If neither L nor R is specified, L is assumed. 

Action 

This command selects the echoing used by the 4027 when text from the keyboard is 
directed into the monitor and the 4027 is in unbuffered mode. 
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Examples 

!ECH<CR> 
!ECH L<CR> 

!ECH R<CR> 


Sets the 4027 for local echo. 


Sets the 4027 for remote echo. 


The 4027 remembers its ECHO setting, even when powered off or RESET. 
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BUFFERED Command 

The 4027 can operate either in unbuffered mode or buffered mode. These modes of 
operation differ in the way that the 4027 processes information from the keyboard. 

When the 4027 is in unbuffered mode, each character typed into the monitor is 
immediateiy transmitted to the host. Under these circumstances, it is not possible to 
locally edit the information displayed in the monitor. As soon as a character appears in 
the monitor window, it has already been sent to the computer. Text typed into the 
workspace is not sent to the computer until the SEND command is given and executed. 
When the SEND command is executed, all the text in the workspace is sent to the 
computer in an uninterrupted stream. 

When the 4027 is in buffered mode, characters entered in the monitor are stored in the 
display memory until RETURN is pressed. Anytime before RETURN is pressed, the current 
line can be edited locally. When RETURN is pressed, the 4027 stores the line in a 
transmit buffer followed by an end-of-line string. The line remains in the transmit buffer 
until it is processed. 

Each line typed in the workspace is stored there and can be edited locally, even after 
RETURN is pressed. When the SEND command is given, the entire workspace contents 
are read into the transmit buffer for processing; at that time, an end-of-line string is added 
to the end of each line. 

The contents of the transmit buffer are processed line by line on a first-in/first-out basis. 
To do this, the 4027 uses a switching arrangement involving prompts (prompt strings) 
from the computer and EOL (end-of-line) strings from the 4027. 

When the computer is ready to receive data, it sends a prompt to the terminal. When the 
terminal receives this prompt, it knows the computer has finished its transmission and is 
ready to receive data. The terminal waits an amount of time specified by the DELAY 
command to insure that the computer is ready to receive. (Refer to the description of the 
DELAY command in this section.) The terminal then processes the oldest (first-in) line in 
its transmit buffer: information destined for the computer is sent there and 4027 
commands are executed. When the entire line has been processed, the terminal sends an 
EOL string to the computer. When the computer sees the EOL string, it knows the terminal 
has finished processing a line and is waiting for data. If the computer has data for the 
terminal, it sends this out, followed by a prompt.; if the computer has no data to send but 
wants data from the terminal, it simply sends a prompt. So it goes, with suitable 
arrangements to begin and end this conversation. 

The 4027 powers up in unbuffered mode. It remains in unbuffered mode until placed in 
buffered mode by the BUFFERED command. 
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Syntax 

IBUFfered [ Yes|No]<CR> 

If neither Y nor N is specified, Y is assumed. 


Action 

If Y (Yes) is specified, the terminal is placed in buffered mode. If N (No) is specified, the 
terminal is placed in unbuffered mode. 

When a BUFFERED YES command is given by the host, each subsequent line of text 
typed on the keyboard is held in the terminal’s output buffer until the host has sent a 
prompt requesting that line. When a BUFFERED YES command is typed on the keyboard, 
the same is true, except that the 4027 behaves as if it has already received the first 
prompt: the first iine typed on the keyboard will be sent as soon as it is terminated: 
subsequent iines each require a prompt before they are sent. 


Examples 

!BUF<CR> Places the 4027 in buffered mode. 

IBUF Y<CR> 

IBUF N<CR> Removes the 4027 from buffered mode. 


The 4027 powers up in unbuffered mode, and RESETs to unbuffered mode. Pressing the 
BREAK key twice in quick succession also removes the 4027 from buffered mode. 
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EOL (End-of-Line) Command 

When the 4027 sends information to the computer, it sends an end-of-line string at the 
end of each line of text. This end-of-line string tells the computer where one line of text 
ends and the next line begins. In buffered mode, it also informs the computer that the 
terminal has finished current processing tasks and can receive data from the computer. 
Some computers expect to see <CR> (carriage return) at the end of each line; others 
may expect to see <CR><LF> (carriage return, line feed) or other strings at the end of 
each line. 

When the operator types text into the monitor destined for the computer, an end-of-line 
string is inserted whenever RETURN is pressed. When text from the workspace is sent to 
the computer (with a SEND command), an end-of-line string is inserted at the end of each 
line of text. (In buffered mode, as the computer requests each line of text from the 
terminal, the terminal sends that line, and inserts an end-of-line string at the end of the 
line.) The EOL command is used to set the 4027 end-of-line string. 


Syntax 

lEOL [<string>]<CR> 
where <string> may be: 

1. One or more delimited ASCII strings. 

2. A sequence of ADE values separated by spaces, or commas. 

3. Any combination of 1 and 2. 

The end-of-line string defined by this command must not be more than ten characters in 
length. If <strlng> Is not specified, it defaults to <CR> (carriage return). 


Action 

This command sets the end-of-line string which the 4027 sends to the computer at the 
end of each line of text. 


@ 


4027 PROGRAMMER’S 


5-21 


STATUS/INITIALIZATION 

EOL COMMAND 


Examples 

!EOL<CR> Sets the 4027 end-of-line string to carriage return, 

!EOL 13<CR> <CR>, with ADE 13. 

!EOL 13 10<CR> Sets the end-of-line string to <CR><LF>. 

!EOL /**$/ 13 10<CR> Sets the end-of-line string to the ASCII string 

**$<CR><LF>. 

The 4027 remembers its end-of-line string when it is powered off or RESET. 
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PROMPT Command 

In buffered mode, when the host computer is ready to accept another line of text from the 
4027, it sends a prompt or prompt string as a cue for the terminai to transmit another iine. 
The prompt must always be the last character(s) sent by the computer. If characters are 
received by the terminal after the prompt character(s), the terminal may assume that the 
computer is stiii transmitting. If there is any doubt about controi characters being sent 
after the prompt, the program can be run in SNOOPY, UNBUFFERED mode so that the 
output may be examined. Prompt strings vary with the computer and with the program; but 
the prompt to which the 4027 responds must agree with the prompt sent from the 
computer. The 4027 prompt string is set using the PROMPT command. 


Syntax 

iPROmpt [<string>]<CR> 
where <string > may be: 

1. One or more deiimited ASCII strings. 

2. A sequence of ADE values separated by spaces or commas. 

3. Any combination of 1 or 2. 


The <string> parameter may not define a string of more than ten ASCII characters. 
If <string> is omitted, the prompt string is set to the line feed character, <LF>. 


Action 

This command sets the 4027 prompt string to <string>. In buffered mode, the 4027 
waits to receive <string> from the computer before processing the next line in its 
transmit buffer. 
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Examples 

!PRO /**$/<CR> Sets the prompt string to **$. In buffered mode, the 

4027 must receive this string from the host before it 
sends a line of text from its transmit buffer. 

!PRO 13 10<CR> Sets the prompt string to <CR><LF>, with ADEs 13 

and 10, respectively. 

!PRO /**$/13 10<CR> Sets the prompt string to **$<CR><LF>. 
!PRO<CR> Sets the prompt string to the default setting, <LF>. 

The 4027 remembers its prompt string when RESET or powered off. 
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DELAY Command 

Sometimes it is desirable that the 4027 not respond immediately to a prompt from the 
computer. If the 4027 is executing a SEND command on a rather full workspace and the 
computer’s input buffers are small, it is possible for the 4027 transmission to overrun this 
input buffer. Information is lost and communications are garbled. 

The prompt string may be used in other ways as well. Suppose the prompt string is <LF> 
and the computer is sending a paragraph of straight text to the 4027. There will be many 
line feeds which are not intended as prompts. If the 4027 waits before responding to a 
<LF>, and another character is received, the 4027 knows to cancel the planned 
response and keep listening to the computer for more text. 

The 4027 transmission delay is set using the DELAY command. 


Syntax 

IDELay <time><CR> 
where <time> is a positive integer. 


Action 

This command sets the transmission delay to <time> milliseconds. In buffered mode, 
after a prompt is detected, the 4027 waits at least <time> milliseconds before 
transmitting anything back to the computer. 


Examples 

IDEL 20<CR> Causes the 4027 to wait at least 20 milliseconds 

before responding to a prompt from the computer. 

IDEL 0<CR> The 4027 responds immediately to a prompt from the 

computer. 


The 4027 remembers its delay time when it is RESET or powered off. 
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FIELD Command 

When the 4027, in form fillout mode, sends form fields to the host computer in a SEND 
operation, the computer must know when a new field begins. This can be arranged in two 
ways: 

• Fields sent to the computer are preceded by a field separator character; each time 
the computer sees this character it knows a new field immediately follows. If a 
field has not been completely filled out, only the filled out portion of the field is 
transmitted; trailing spaces are not sent. 

• Each field is sent in its entirety, including trailing spaces. The choice of which 
method to use is determined largely by the programming language used. (See 
Forms and Form Fillout for details.) 

The 4027 is instructed how to send form fields to the host by using the FIELD command. 


Syntax 

IFIEId [<character>]<CR> 

where <character> is a single printing ASCII character, or a 2- or 3-digit ADE between 
00 and 127, inclusive. 

If no parameter is specified, it is assumed to be NUL. 


Action 


This command sets the character which precedes fields of a form when they are 
transmitted to the computer by the 4027. If no value is supplied, then no character is 
inserted before a field, and trailing spaces are sent. Common choices for the field 
separator are TAB, CR, and US. 
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Examples 

!FIE@<CR> Sets the field separator to the @ character, with ADE 

!FIE 64<CR> 64. This character precedes each field of a form sent 

to the computer. 

!FIE<CR> When fields of a form are sent to the computer, no field 

separator is used. Each field is sent in its entirety, 
including all trailing spaces. 

The 4027 remembers the field separator when RESET or powered off. 
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EOF (End-of-File) Command (Requires Option 3 or 4) 

The 4027 can copy a file from one device to another by using the COPY command. When 
the data comes from the host, the 4027 looks for an end-of-file string to know when to 
stop the COPY operation. It also sends the EOF string to the host at the end of a copy. 

The end-of-file string is selected using the EOF command. 

Syntax 

!EOF [<string>]<CR> 
where <string> consists of: 

1. One more delimited ASCII strings. 

2. A sequence of ADE values separated by spaces or commas. 

3. Any combination of 1 and 2. 

This command may not define an ASCII string of more than ten characters. If <string> is 
not specified, it defaults to /*. 

Action 

This command sets the end-of-file string. This string marks the end of a file transferred by 
a COPY command. See the Peripherals section. 

Examples 

!EOF/$**/<CR> Sets the end-of-file string to the ASCII string, $* *. This 

string marks the end of a file transferred by a COPY 
command. 

!EOF 27 27 7<CR> Sets the end-of-file string to **<ESC>. 

!EOF<CR> Sets the end-of-file string to its default value, /*. 

The 4027 remembers the EOF setting when RESET or powered off. 
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DUPLEX Command (Requires Option 1) 

The 4027 with Option 1 may be set for either fuil duplex or half duplex communications. 

Fuli dupiex mode is used with fuil duplex communication lines, which permit both terminai 
and host to transmit at the same time. Haif duplex is used with half duplex communications 
lines, over which oniy one device (terminai or host) can transmit at a time. 

Haif duplex communications can use either normai or supervisor mode. 

In half duplex communications, the 4027 can aiso be set to respond to either “iine 
turnaround oniy” or “prompt string plus line turnaround” as the prompting condition in 
buffered mode. 

The DUPLEX command is used to set the 4027 for haif duplex or full duplex 
communications. 


Syntax 

IDUPlex [<fuiidup> I <halfdup>]<CR> 
where <fuiidup> = Fuli 

<halfdup> = Haif [Supervisor I Normai][Line I Prompt] 

If no parameters are specified, fuil duplex operation is assumed. If half duplex is chosen, 
supervisor mode and iine are the default parameters. 


Action 

This command sets the 4027 for either fuli dupiex or haif dupiex communications. If half 
duplex is chosen, either Supervisor or Normal mode is chosen. Aiso, the prompt condition 
to which the 4027 responds in buffered mode is set to either Line (line turnaround oniy) 
or Prompt (prompt string plus line turnaround). 


Examples 

!DUP<CR> Sets the 4027 for fuli duplex. 

!DUPF<CR> 
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!DUP H<CR> 
!DUPHS<CR> 
!DUP H S L<CR> 

!DUP H S P<CR> 


!DUP H N<CR> 
!DUP H N L<CR> 

!DUP H N P<CR> 


Sets the 4027 for half duplex with supervisor. In 
buffered mode the prompt condition is line turnaround 
only. 

Sets the 4027 for half duplex with supervisor. In 
buffered mode the prompt condition is the prompt 
string plus line turnaround. 

Sets the 4027 for half duplex normal. In buffered mode 
the prompt condition is line turnaround only. 

Sets the 4027 for half duplex normal. In buffered mode 
the prompt condition is the prompt string plus line 
turnaround. 


The 4027 remembers its duplex setting when RESET or powered off. 
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DISCONNECT Command (Requires Option 1) 


Syntax 

!DISConnect<CR> 


Action 

This command sends a signai to the modem, causing it to disconnect the 4027 from the 
communications line. (The terminal turns off the “data terminal ready” signal on the RS- 
232 interface for about one second. This causes the modem to disconnect from the 
communications line.) 


Example 

!DISC<CR> Disconnects the 4027 from the communications line. 


NOTE 

DISCONNECT may not be abbreviated to the first three letters (DIS) as this 
would conflict with the DISABLE command. 
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STATUS MESSAGES 

In addition to the commands which set the 4027 terminai parameters and communica¬ 
tions parameters, there are four “status” messages which display, on the screen, 
information about the parameter settings and internal status of the terminal. These are the 
STATUS message, the SYSTAT message, the system TEST message, and a GTEST 
(Graphic Test) message. 


The STATUS Key and The STATUS Message 

At any time, the 4027 operator may press the STATUS (SHIFT-COMMAND LOCKOUT) 
key to get a brief STATUS message. This message is displayed in the monitor, without 
disturbing the contents of the workspace. The STATUS message shows whether the 4027 
is in buffered or unbuffered mode, the command character, and the number of unused 
blocks of terminal memory. (A block consists of 16 eight-bit bytes. One block holds at 
most 14 characters.) A status message is shown in Figure 5-1. 



Figure 5-1. STATUS Message. 


SYSTAT and The SYSTAT Message 

The 4027 has a SYSTEM STATUS, or SYSTAT, message which lists most of the 
parameter settings discussed in this section. The SYSTAT command displays the 
SYSTAT message in the monitor. 


Syntax 


!SYStat<CR> 
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SYSTAT Parameters 

The 4027 SYSTAT message lists the following parameters, using the abbreviations 
shown. 

TB — Transmit baud rate 

RB — Receive baud rate 

DL — Delay time 

LM — Left margin 

RM — Right margin 

WL — Number of workspace lines displayed on the screen 

V# — Firmware version number 

TS — Tab stops 

CC — Command character 

FS — Field separator 

PR — Prompt string 

EL — End-of-line string 

DU — Duplex (DU=F means full duplex, DU = H means half duplex.) 

BU — Buffered mode (Y means buffered, N means unbuffered.) 

EC — Echo (EC=R means remote echo, EC=L means local echo.) 

FF — Form fillout mode (Y means yes, N means no.) 

SN — Snoopy mode (Y means yes, N means no.) 

KB — Keyboard (KB=M means text typed on the keyboard is directed to the monitor, 
KB=W means text from the keyboard is sent to the workspace.) 

CM — Communications line {CM = M means text from the communications line is 
directed to the monitor, CM=W means such text is sent to the workspace.) 

PA — Parity (N means none, D means data, E means even, O means odd, H means 
high.) 

C0-C7 — Color numbers C0-C7 are displayed with color samples and the HLS 
parameters for each color. 


If the 4027 contains Option 10 (Polling Interface) an additional field, PL=, appears. This 
field is followed by a two-digit decimal number indicating the polling address of this 
display station. 

If the 4027 contains Option 1 (Half Duplex) and the 4027 is set for half duplex 
communications, the DU field may contain one or two additional letters. See the DUPLEX 
command description earlier in this section for details. 
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If a parameter is set to an ASCII control character, the two-letter mnemonic for that 
character is shown in the parameter setting. The SYSTAT message is illustrated by Figure 
5-2. 



Figure 5-2. The 4027 SYSTAT Message. 


When the 4027 is turned off or RESET, it remembers some of the parameter settings in 
the SYSTAT message, and resets others to default settings. Those settings which are 
remembered are: TB, RB, DL, LM, RM, TS, CC, FS, PR, EL, DU, EC, and PA (and the PL 
setting, if present). 

When the 4027 is powered up or RESET: 

• WL = O (There is no workspace defined.) 

• BU = N (The 4027 is in unbuffered mode.) 

• FF = N (The 4027 is not in form fillout mode.) 

• SN = N (The 4027 is not in snoopy mode.) 

• KB = M and CM = M (Both the keyboard and the computer direct text to 

the monitor.) 

• C0-C7 = (All eight colors are displayed with their default HLS parameters. 

Color C7 (black) is not visible.) 

The V# setting will not change unless a different firmware version is installed in the 
4027. 
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TEST Command 

The command: 

!TEST<CR> 

or 

!TES<CR> 

causes the 4027 to run a program which checks whether the terminal memory and 

display are operating properly. The following actions occur: 

• The terminal erases the entire display list and creates a 34-line monitor window. 

• System ROM (Read Only Memory), system RAM (Random Access Memory), and 
display RAM are checked. The four system ROM checksums are displayed. An 
error in display RAM prevents a bad block of memory from being used; the number 
of free blocks is reduced, but the terminal operates correctly. 

• After the memory test, the lights on the four lighted function keys are turned on, all 
128 ASCII characters are displayed in the monitor in snoopy mode, and all Font 1 
characters (ruling characters) are displayed. (If this character set is not installed, 
each of its characters is displayed as a dot matrix with every dot turned off.) 

• After the two character sets are displayed, a sample of colors C0-C6 is 
represented by displaying three upper-case letter A’s in each color. Color C7 
(black) is not visible. 

• At the end of the test, the lights on the function keys are turned off and the bell is 
rung. 

Should the test reveal a failure in the system RAM, the message “RAM ERROR” appears. 

If such a message appears, call your Tektronix service personnel. 


NOTE 

Running this test destroys any text or key definitions which may have been 
stored in the 4027 memory. 


An example of the display created by a successful TEST on the 4027 is shown Figure 5-3. 
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Figure 5-3. 4027 !TEST<CR> Results. 
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GTEST Command 

The 4027’s Graphics Memory can be tested by the command; 

!GTEST<CR> 

or 

!GTE<CR> 

causes the 4027 to test its graphic memory. 

When this command is executed, the entire display list is erased and a 34-line monitor 
window is created. The terminal then tests its graphic memory. After a delay of about 15 
seconds while it performs the test, the terminal displays the test results in the monitor, 
starting with font 1 and proceeding to font 31. If no RAM is installed for a particular 
character set, the 4027 displays a “NO MEM” message. If RAM is installed, each 
character Is tested twice (each bit is tested for both 1 and 0). If the RAM passes the test, 
the 4027 displays “OK” for each of these two tests. If the RAM for a particular character 
set fails the test, the 4027 displays the “RAM ERROR” message and an error code for use 
by Tektronix service personnel. 

A sample display of a successful GTEST Is shown in Figure 5-4. 
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Figure 5-4. 4027 !GTEST<CR> Results. 
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CONTROLLING THE DISPLAY 


Before information is displayed on the terminai screen, decisions must be made regarding 
the set-up of the screen: how the screen’s 34-line display is to be divided between the 
workspace window and the monitor window; which scroll is to receive text from the 
computer and which from the keyboard; and margins and tab stops. The commands which 
set these parameters are discussed in the System Status and Initialization section. We 
assume here that these parameters have been set. Throughout this section we assume 
the left workspace margin is set to column one. 


THE CURSOR COMMANDS 

Explanation of the 4027 will involve reference to three cursors. One, called the graphic 
cursor or crosshair, is used in the creation of graphic displays and is discussed in the 
Graphics section. This section will discuss only the other two cursors; the workspace 
cursor and the monitor cursor. Only one of these is visible at a given time. Since, in either 
window, the cursor indicates the position at which new information will be printed on the 
screen, one may wish to change the cursor position at various times. 

The programmer uses commands to position the cursor at a desired location. (The 
operator may give these same commands from the keyboard or use the corresponding 
keys.) The commands which affect the cursor position are the cursor commands (JUMP, 
UP, DOWN, RIGHT, LEFT) and the tab commands (TAB, BACKTAB). In addition, even 
though there is no “HOME” command corresponding to the HOME key, the JUMP 
command can be used to simulate the action of the HOME key. (See discussion of the 
JUMP command.) 


NOTE 

If a cursor movement command, tab command, or scrolling command is 
typed on the keyboard and text from the keyboard is directed into the 
monitor, execution of the command inserts a line just below the line on 
which the command is typed. 
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JUMP Command (Workspace only) 


Syntax 

lJUMp [<row>[<column>]]<CR> 

where <row> is a positive integer, and <column> is a positive integer not greater than 
80. If only one parameter is specified, it is assumed to be the <row> parameter. If neither 
parameter is specified, both <row> and <column > default to one. 


Action 

This command positions the workspace cursor in the row and column of the workspace 
designated by <row> and <column>, respectively. 

Picture the workspace scroll as a long table with an indeterminate number of rows, each 
row having 80 columns (Figure 6-1). The topmost row in the workspace, (whether it 
contains text or is blank) is labeled row 1, the next row is row 2, and so forth. In each row, 
columns are labeled column 1, column 2,..., 80. This establishes an absolute coordinate 
system in the workspace scroll. Portions of this scroll may be visible in the workspace 
window. 

The JUMP command moves the workspace cursor to the specified row and column of the 
workspace, expressed in absolute workspace coordinates. The destination of the cursor 
does not depend on its current location. (This is in contrast to the other cursor movement 
commands, whose parameters specify positions relative to the current cursor position.) 

If the <row> parameter specifies a row of the workspace below the bottom of the 
workspace window, the workspace rolls up and stops with the line containing the cursor 
at the bottom of the window. If <row> exceeds the current number of lines in the 
workspace, blank lines are created at the bottom of the workspace and the <row>-th row 
is displayed as the last row in the workspace window. 

If the <row> parameter specifies a row of the workspace above the top of the workspace 
window, the workspace rolls down, stopping with the row containing the cursor at the top 
of the window. 
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Line 1 
Line 2 



UqS-N_ _ 

\ / 
(N,1) (N,80) 

Row N, Column 1 Row N, Column 80 



WORKSPACE 

WINDOW 



2402-9 


Figure 6-1. The Workspace Window and the Workspace Scroll. 


NOTE 

This command appiies only, and always, to the workspace cursor. It is not 
necessary for the workspace to receive text from the computer or the 
keyboard for this command to move the workspace cursor. When the 
workspace cursor next appears, it appears at the location specified in the 
JUMP command (assuming no other instructions which affect the 
workspace cursor location have been given to the terminal meanwhile). 
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Examples 

1. The command 

UUM 3,10<CR> 

moves the workspace cursor to row 3, column 10. 

2. Either of the commands 

!JUM 3<CR> 

!JUM3,1<CR> 

moves the workspace cursor to row 3, column 1. 

3. Any one of the commands 

!JUM<CR> 

UUM 1 <CR> 

UUM 1,1 <CR> 

moves the workspace cursor to row 1, column 1. Each of these commands is 
equivalent to pressing the HOME key when the workspace cursor is visible and 
the terminal is not in form fillout mode. 
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UP Command 


Syntax 

!UP [<count>]<CR> 

where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 

This command is equivalent to pressing the up cursor key (pad key 8, marked |) 

<count> times. 

This command can be used to move either the workspace cursor or the monitor cursor. If 
the command is typed on the keyboard, it moves the cursor in that scroll which receives 
text from the keyboard. If the command is sent from the computer, it moves the cursor in 
that scroll which receives text from the computer. 

Suppose text from the computer is printed in the workspace and the command 
lUP <count><CR> 

is sent from the computer. This command moves the workspace cursor up <count> lines 
from its current position, leaving the column location unchanged. 

If <count> is large enough to move the cursor to a line not visible in the workspace 
window, the workspace rolls down so that the line which the cursor moves to is the top 
line in the window. However, the cursor will not move past the first line of the workspace, 
regardless of how large <count> is. 

If text from the computer is printed in the monitor and this command is sent from the 
computer, it has the same effect on the monitor cursor. 


@ 


4027 PROGRAMMER’S 


6-5 



CONTROLLING THE DISPLAY 

UP COMMAND 


Examples 


Suppose text from the computer is printed in the 
workspace, with the cursor in iine 23, coiumn 5: 



1. The command 


Line 1 
Line 2 
Line 3 


D 


!UP3<CR> 

positions the cursor in iine 20, column 5. 



-AFTER !UP 3<CR> 
CURSOR IN LINE 20, 
COLUMN 5 


2. The subsequent command 


^Line 1 
Line 2 
Line 3 


D 


!UP 7<CR> 


causes the workspace to roll down and 
positions the cursor in line 13, column 5. 


/fTIneja. 

I Line 14 


Line 20 
Line 21 


-AFTER !UP 7<CR> 
CURSOR IN LINE 13, 
COLUMN 5 
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3. The subsequent command 
!UP 13<CR> 

rolls the workspace down, leaving the cursor 
in column 5 of line 1. Since the workspace 
will not scroll past the first line, the com¬ 
mands 



lUP 14<CR> 

!UP 15<CR> 

each have the same effect. 
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DOWN Command 

Syntax 

!DOWn [<count>]<CR> 

where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 

This command is equivalent to pressing the down cursor key (pad key 2, marked |) 
<count> times. 

This command can be used to move either the workspace cursor or the monitor cursor. If 
the command is typed on the keyboard, it moves the cursor in that scroll which receives 
text from the keyboard. If the command is sent from the computer, it moves the cursor in 
that scroll which receives text from the computer. 

Suppose text from the computer is printed in the workspace and the command 
IDOW <count><CR> 

is sent from the computer. This command moves the workspace cursor down <count> 
lines from its current position, leaving the column location unchanged. 

If <count> is large enough to move the cursor to a line not visible in the workspace 
window, the workspace rolls up until the line which the cursor moves to is at the bottom of 
the window. If <count> is large enough to move the cursor past the last line in the 
workspace, enough blank lines are created at the bottom of the workspace to 
accommodate this command. 

if text from the computer is printed in the monitor and this command is sent from the 
computer, it has the same effect on the monitor cursor. 

Pressing the LINE FEED key <count> times has the same effect on the cursor. Pressing 
this key also generates the ASCII Line Feed character, while pressing the down cursor 
key does not. 
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Examples 

Suppose a workspace window of ten lines is 
defined, and the workspace contains 20 lines of text 
(some of which may be blank). Suppose also that 
line 1 is the top line in the workspace window and 
the cursor is in line 1, column 6. 



1. The command 
!DOW8<CR> 

moves the cursor down eight lines to line 9, 
column 6. No roll up occurs. 


2. The subsequent command 
!DOW5<CR> 

moves the cursor to line 14, column 6; the 
workspace rolls up four lines. 


3. The subsequent command 
IDOW 10<CR> 

adds four blank lines at the bottom of the 
workspace and rolls the workspace up 10 
lines. The cursor stops in the last blank line 
created, at the bottom of the workspace 
window. 
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RIGHT Command 

Syntax 

IRIGht [<count>]<CR> 

where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 

This command is equivalent to pressing the right cursor key (pad key 6, marked —*) 
<count> times. 

This command can be used to move either the workspace cursor or the monitor cursor. If 
the command is typed on the keyboard, it moves the cursor in that scroll which receives 
text from the keyboard. If the command is sent from the computer, it moves the cursor in 
that scroll which receives text from the computer. 

Suppose text from the computer is printed in the workspace and the command 
!RIG <count><CR> 

is sent from the computer. This command moves the workspace cursor <count> 
columns to the right. 

If <count> is large enough to move the cursor beyond column 80, the cursor wraps 
around to the left margin of the next line and continues moving right a total of <count> 
columns. If this action requires the cursor to move to a line which is not visible in the 
workspace window, the workspace rolls up so that the line in which the cursor stops is 
the bottom line in the window. If this command requires the cursor to move beyond the 
last line of the workspace, enough blank lines are created at the bottom of the scroll to 
accommodate this command. 

If text from the computer is printed in the monitor and this command is sent from the 
computer, it has the same effect on the monitor cursor. 
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Example 

Suppose there is a workspace window of ten lines, 
with ten lines of text in this window. The left margin 
is set at column 1 and the cursor is in column 1 of 
line 8. 



1. The command 


IRIG 7<CR> 


moves the cursor right seven columns to 
column 8 of line 8. 



2. The subsequent command 


IRIG 153<CR> 


moves the cursor through the remaining 73 
columns of line 8 to column 1 of line 9, then 
through the 80 columns of line 9 to column 1 
of line 10. No roll up occurs. 



3. The subsequent command 
IRIG 167<CR> 

moves the cursor through the 80 columns of 
line 10, creates a blank line 11 and moves 
the cursor through the 80 columns of line 
11, creates a blank line 12 and moves the 
cursor through seven columns to column 8 
of line 12. The workspace rolls up to display 
line 12 as the last line in the workspace 
window. 
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LEFT Command 

Syntax 

!LEFt [<count>]<CR> 

where <count> is a positive integer, if <count> is not specified, it defauits to one. 


Action 

This command is equivaient to pressing the ieft cursor key (pad key 4, marked —) 
<count> times. 

This command can be used to move either the workspace cursor or the monitor cursor. If 
the command is typed on the keyboard, it moves the cursor in that scroll which receives 
text from the keyboard. If the command is sent from the computer, it moves the cursor in 
that scroll which receives text from the computer. 

Suppose text from the computer is printed in the workspace and the command 
!LEF <count><CR> 

is sent from the computer. This command moves the workspace cursor <count> 
columns to the left. 

If <count> is large enough to move the cursor to the left of the left margin, the cursor 
wraps around to column 80 of the preceding line and continues moving left a total of 
<count> columns. If this action requires the cursor to move to a line which is not visible 
in the workspace window, the workspace rolls down so that the cursor stops in the top 
line of the window. However, the cursor will not move above the first line in the workspace. 
Thus this command does not insert blank lines at the top of the workspace. 

If text from the computer is printed in the monitor and this command is sent from the 
computer, it has the same effect on the monitor cursor. 
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Examples 

Suppose a workspace is defined and the cursor is 
visible in column 10 of line 6. 



1. The command 
!LEF9<CR> 

moves the cursor to column I of line 6. 



2. The subsequent command 
!LEF 150<CR> 

moves the cursor through the 80 columns in 
line 5, rolls down the workspace to display 
line 4, and moves the cursor through the 
rightmost 70 columns in line 4. The cursor 
stops in column 11 of line 4. 



3. The subsequent command 
!LEF300<CR> 

moves the cursor through the leftmost ten 
columns in line 4, then through the 80 
columns in each of lines 3, 2, and 1, rolling 
the workspace down to display these lines. 
The cursor stops at column 1 of line 1. 
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THE TAB COMMANDS 

TAB Command 

Syntax 

!TAB [<count>]<CR> 

where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 

This command is equivalent to pressing the TAB key <count> times. 

This command can be used to move either the workspace cursor or the monitor cursor. If 
the command is typed on the keyboard, it moves the cursor in that scroll which receives 
text from the keyboard. If the command is sent from the computer, it moves the cursor in 
that scroll which receives text from the computer. 

Suppose text from the computer is printed in the workspace and the command 
ITAB <count><CR> 

is sent from the computer. This command moves the workspace cursor <count> tab 
stops to the right. If there are no tab stops defined to the right of the current cursor 
position, the next tab moves the cursor to the beginning of the next line. Thus if <count> 
is large enough to move the cursor past the last tab stop in a line, the cursor jumps to 
column 1 of the next line and continues tabbing a total of <count> stops. Each skip to 
the next line, as well as each skip to the next tab stop in a line, accounts for one of the 
<count> tabs. If <count> is large enough to move the cursor below the bottom of the 
workspace window, roll up occurs. 

If <count> is large enough to move the cursor past the last line in the workspace, 
enough blank lines are created at the bottom of the workspace to accommodate the 
command. 

If the text from the computer is printed in the monitor and this command is sent from the 
computer, it has the same effect on the monitor cursor. 
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Examples 

Suppose there is a workspace window of ten lines, 
with tab stops in columns 10, 20, and 30, and the 
cursor is in line 9, column 1. 



1. The command 
!TAB4<CR> 

moves the cursor to the three stops in line 9 
and then to column 1 of line 10. 



2. The subsequent command 
ITAB 17<CR> 

moves the cursor to column 10 (the first 
stop) in line 14. The first 16 tabs move the 
cursor through lines 10,11,12, and 13, to 
column 1 of line 14; the final tab moves the 
cursor from column 1 of line 14 to the first 
tab stop in line 14. 



NOTE 

The TAB command, like the TAB key, performs a different action when the 
4027 is in form fillout mode. See the Forms and Form Fillout section for 
details. 
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BACKTAB Command 

Syntax 

IBACktab [<count>]<CR> 

where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 

This command is equivaient to pressing the BACKTAB key (SHIFT-BACKSPACE) 
<count> times. 

This command can be used to move either the workspace cursor or the monitor cursor. If 
the command is typed on the keyboard, it moves the cursor in that scroll which receives 
text from the keyboard. If the command is sent from the computer, it moves the cursor in 
that scroll which receives text from the computer. 

Suppose text from the computer is printed in the workspace and the command 
!BAC <count><CR> 

is sent from the computer. This command moves the workspace cursor <count> tab 
stops to the left. Each backtab moves the cursor one tab stop to the left, or to the left 
margin if there are no tab stops to the left of the cursor position. The cursor does not 
move to a preceding line of text, regardless of how large <count> is, but “sticks” at the 
left margin of the current line. 

If text from the computer is printed in the monitor and this command is sent from the 
computer, it has the same effect on the monitor cursor. 
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Examples 


Suppose tab stops are set at columns 10, 20, 30, 
and 40 and the cursor is in column 35. 



1. The command 


!BAC<CR> 


moves the cursor left one stop to column 30 
of the current line. 



2. Any of the subsequent commands 


!BAC3<CR> 

!BAC4<CR> 



moves the cursor to column 1 of the current 
line. 


NOTE 

The BACKTAB command, like the BACKTAB key, performs a different 
action when the 4027 is in form fillout mode. See the Forms and Form 
Fillout section for details. 
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THE SCROLLING COMMANDS 

RUP (Roll Up) Command 

Syntax 

!RUP [<count>]<CR> 

where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 

This command is equivalent to pressing the up scrolling key (pad key 7, marked A) 
<count> times. 

This command rolls up the current scroll (workspace or monitor) <count> lines, or until 
the last line of the scroll is visible at the bottom of the window. This command does not 
create blank lines at the end of the scroll. If <count> is larger than the number of lines 
remaining in the scroll, the scroll rolls up until the last line of the scroll is visible in the 
window, then stops. 

When the scroll rolls up, the cursor moves with it, remaining in the same line of text, at the 
same column position, as long as that line of text remains visible. If that line of text passes 
out of the window, the cursor “sticks” at the top of the window, with the column position 
unchanged. 


Examples 


Suppose a workspace window of ten lines is 
defined, the workspace scroll contains 30 lines, and 
the cursor is in line 9, column 5. 
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1. The command 


!RUP8<CR> 


leaves line 9 at the top of the workspace, 
with the cursor in line 9, column 5. 


^Line 1 
Line 2 


D 


AFTER !RUP8<CR> 
CURSOR IN LINE 9, COLUMN 5 
AT TOP OF WORKSPACE WINDOW 



Line 29 
Line 30 


D 


2. The subsequent command 


!RUP 10<CR> 


leaves line I9 at the top of the workspace 
window, with the cursor in line I9, column 5. 



3. Any of the subsequent commands 


IRUP 2<CR> 
!RUP3<CR> 


leaves line 30 at the bottom of the work¬ 
space window, with the cursor in line 21, 
column 5. 
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RDOWN (ROLL DOWN) Command 

Syntax 

IRDOwn [<count>]<CR> 

where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 

This command rolls down the current scroll (workspace or monitor) <count> lines, or 
until the first line of the scroll is at the top of the window. The RDOWN command cannot 
be used to insert blank lines at the top of the workspace. 

Giving this command is equivalent to pressing the down scrolling key (pad key 1, marked 
▼) <count> times. 

When the current scroll rolls down, the cursor moves with it, remaining at the same row 
and column position as long as that position is visible in the window. If that position 
passes out of the window, the cursor “sticks” at the bottom line of the window, with the 
column position remaining unchanged. 


Examples 


'une 1 
Line 2 


D 


Suppose a workspace window of ten lines is 
defined, with a workspace scroll of 30 lines and the 
cursor positioned in line 21, column 5. 


r 

4-_1 

n 


Line_21 



Line 22 ~ 

Line 29 

Line 30 

iiill 
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1. The command 


!RD0 9<CR> 


rolls the workspace down 9 lines, leaving the 
cursor stili positioned in iine 21, column 5. 



2. The subsequent command 


f Line 1 
Line 2 


D 


!RD0 6<CR> 


rolls the workspace down an additional six 
lines, leaving the cursor in line 15, column 5, 
at the bottom of the window. 



Line 29 
Line 30 


D 


3. Any of the subsequent commands 

IRDO 5<CR> 

IRDO 6<CR> 

!RD0 7<CR> 


rolls the workspace down five lines, with the 
cursor in line 10, column 5, at the bottom of 
the window. 
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ADDITIONAL COMMANDS 

ERASE Command 

Syntax 

lERAse [ Workspace | Monitor ]<CR> 


Action 

This command erases the specified scroli. The entire scroil, not just the portion visible in 
the \window, is erased. If text is currently directed into that scroll, the cursor quickly 
reappears in the home position (line 1, column 1, in the upper left corner) of the window, if 
text is not currently directed into that scroll, the next time that cursor appears, it appears 
in the home position. This command does not affect the size of the workspace and 
monitor windows. 

If no parameter is specified, the source of the command determines which scroll is 
erased. If the commmand is sent from the computer and no parameter is specified, the 
scroll which receives text from the computer is erased. If the command is typed on the 
keyboard and no parameter is specified, the scroll which receives text from the keyboard 
is erased. 


Examples 

Erases the workspace scroll and returns the workspace 
cursor to the home position. This destroys any graphic area 
which has been defined. 

Erases the monitor scroll and returns the monitor cursor to 
the home position. 

If sent from the computer, this command erases whichever 
scroll receives text from the computer. 

if typed on the keyboard, this command erases whichever 
scroll receives text from the keyboard. 

NOTE 

The ERASE command can also be used to erase the contents of a 
graphics region in the workspace by entering the command !ERA 
G< CR>. See the Graphics section for details. 


1. lERA W<CR> 

2. lERA M<CR> 

3. !ERA<CR> 
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BELL Command 

The 4027 contains a bell. This bell sounds automatically when certain conditions occur; 
for example, the bell rings if the operator types beyond the right margin, or if an attempt is 
made to enter a character in a protected field when the terminal is in form fillout mode. 

The programmer may wish to sound the 4027 bell at various times during an applications 
program — perhaps to remind the operator to enter data, or to press a function key. The 
BELL command is used for this purpose. 


Syntax 

!BELI<CR> 

or 

!BEL<CR> 


Action 

This command sounds the 4027 bell. The bell also sounds when the ASCII BEL character, 
CTRL-G, is sent to the terminal. 
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Section 7 


4027 COLOR COMMANDS 


The 4027 has a palette of 64 distinct colors. Of these 64, eight may be selected at any 
one time to create graphics, to deveiop unique symbois and patterns, and to assign coiors 
(visual attributes) to the character fonts. These eight colors are assigned color numbers 
CO, C1,..., C7, respectively. This section explores the commands used to select and 
invoke the various colors and how patterns may be created. 

Appendix A, the Tektronix Color Standard, should be reviewed before using the 
commands discussed in this section. The Tektronix 4027 Color Standard is a model used 
to explain the relationship between hue, lightness, and saturation and how they are used 
to achieve a particuiar color. 


THE COLOR COMMANDS 

There are five commands which control the selection and assignment of color on the 
display. The COLOR command is used to assign one of the eight coior numbers (C0-C7) 
or one of 120 possible patterns (P0-P119) to be used in any subsequent graphic 
dispiays. The MAP, RMAP, and MIX commands are used to determine which of the 64 
possible colors will be assigned to the eight color numbers. The PATTERN command is 
used to define any of 120 patterns. Each of these commands will be discussed in turn. 
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COLOR Command 

The COLOR command is used to designate the color of subsequent graphics. 

Syntax 

ICOLor <vector color no.>/<vector pattern no.>[<boundary color 
no.>/<boundary pattern no.>]<CR> 

where 

<vector color number> is one of CO, C1.C7. 

< vector pattern no.> is one of PO, PI,..., P119. 

<boundary color no.> is one of CO, C1,..., C7. 

< boundary pattern no.> is one of PO, P1,..., P119. 

Action 

The first parameter (<vector color no.>/<vector pattern no.>) specifies the color or 
pattern which will be used to draw subsequent vectors or fill subsequent polygons. If a 
boundary color or pattern is required, then the second parameter (<boundary color 
no.>/<boundary pattern no.>) is given. The boundary parameter is optional. If no color 
command is given, the default color for subsequent vectors and polygons is CO (default 
white). Valid colors for both vectors and boundaries are C0-C7 and P0-P119. 

Examples 

ICOLor Cl <CR> 

All vectors and polygons will be color Cl (default color red). 

ICOLC1 C2<CR> 

All vectors and polygons will be color C1 (default color red) and the polygons will have a 
boundary color C2 (default color green). 

ICOL PI <CR> 

All vectors and polygons will be pattern PI. 

ICOL PI C4<CR> 

All vectors and polygons will be drawn in pattern PI. The polygons will have a boundary 
of color C4. Pattern PI must be defined by the PATTERN command prior to its use in a 
COLOR command. Refer to the PATTERN command described later In this section. 
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MAP Command 

The 4027 provides a selection of 64 possible colors of which eight (C0-C7) may be 
designated at any one time. If colors other than the eight default colors are desired, the 
MAP command may be used to set the hue, lightness, and saturation to redefine any of 
the eight color numbers. If a MAP command is not given, default colors for C0-C7 are 
white, red, green, blue, yellow, cyan, magenta, and black, respectively. 


Syntax 

IMAP <Cn> <hueangle> <lightness> <saturation><CR> 
where 

<Cn> is one of eight color numbers (C0-C7). 

<hue angle> is an integer from 0 to 360. 

<lightness> and <saturation> are integers from 0 to 100. 


NOTE 

Refer to Appendix A for further information on the Tektronix 4027 Coior 
Standard. 


Action 

The <Cn> indicates which of the eight color numbers (C0-C7) is being MAPped. 

<Hue angle> is a gradation of color measured around a circle as an angle from 0 to 360 
degrees. Referring to the color cone in Appendix A, observe that a <hue angle> of 0 
degrees always specifies one of several shades of blue, 60 degrees magenta, 120 
degrees red, 180 degrees yellow, 240 degrees green, and 300 degrees cyan (360 
degrees = 0 degrees). If a <hue angle> is given between two of these angles, an 
intermediate color is produced. For example, specifying a <hue angle> between 0 and 
60 gives a color between blue and magenta. 

The <lightness> and <saturation> parameters determine which shade of the given hue 
will be produced by a given <hue angle>. Again referring to the color cone in Appendix 
A, notice that <lightness> is expressed as a value between 0 percent (black) at the 
bottom of the cone and 100 percent (white) at the top. This means that any of the colors 
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selected by the <hue angle> parameter will be shaded according to the value given by 
the <lightness> parameter. In addition, if the value of <lightness> is 0 percent, the 
color produced will be black regardless of the <hue angle> or <saturation>. 
Conversely, a <lightness> value of 100 percent always produces white. 

The third parameter of the MAP command, <saturation>, sets the amount of gray to be 
contained at a given <hue angie> and <lightness>. As the saturation approaches 100 
percent, less gray is added and a purer hue is produced. 

NOTE 

Small changes In any of the HLS parameters may not produce a change In 
the MAPped color. For example, if the < hue angle> of 120 degrees, which 
produces red, is changed to 125 degrees, the red hue is still produced. The 
same is true for small changes in the < lightness> and < saturation> 
parameters. A total of 64 colors can be displayed. Each of these is 
invariant over a finite range in each parameter. 

The SYSTAT message displays the HLS (hue, lightness, saturation) parameters assigned 
to each of the colors C0-C7, along with a color sample. All colors return to their default 
parameters when the 4027 is powered off or RESET. 

The default colors for C0-C7 and their respective default parameters are as follows: 

CO (white) - 0,100,100 
Cl (red) - 120,50,100 
C2 (green) - 240,50,100 
C3 (blue) - 0,50,100 
C4 (yellow) - 180,50,100 
C5 (cyan) - 300,50,100 
C6 (magenta) — 60,50,100 
C7 (black) - 0,0,100 

Examples 

IMAP Cl 0,50,100<CR> Sets <color number> Cl (default red) to a <hue 

angle> of 0 degrees (blue), a <lightness> of 50%, 
and <saturation> of 100%. Color number Cl is 
then blue. 

IMAP C4 240,50,50<CR> Sets <color number> C4 (default yellow) to a 

<hue angle> of 240 degrees, <lightness> of 50%, 
and <saturation> of 50%. Color number C4 is then 
green. 
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RMAP (Relative MAP) Command 

The RMAP command changes a color’s HLS parameters by amounts specified relative to 
the current HLS parameters. 


Syntax 

IRMAp <Cn> <hueangle> <lightness> <saturation><CR> 
where 

<Cn> is one of the color numbers CO, C1,..C7. 

<hue angle> is a positive or negative integer from 0 to 360. 

< lightness > and <saturation > are positive or negative integers from 0 to 100. 


Action 

<Cn> is the color number to be redefined. The color may be redefined by changing the 
<hue angle> a number of degrees or by changing the <lightness> or <saturation> a 
given percentage. Any or all of the parameters may be changed in an RMAP command. If 
zero (0) Is entered for any of the parameters, then no change is made to that parameter. 


NOTE 

Small changes in the HLS parameters may not produce a visible change in 
the displayed color. Refer to Appendix A for further information. 


When a SYSTAT command is given, it will display the RMAPped color and the current 
HLS parameters for that color. When the 4027 is powered off or RESET, all eight colors 
return to their default values. 
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The default colors for C0-C7 and their respective default parameters are as follows: 

CO (white) - 0,100,100 
Cl (red) - 120,50,100 
C2 (green) - 240,50,100 
C3 (blue) - 0,50,100 
C4 (yellow) - 180,50,100 
C5 (cyan) - 300,50,100 
C6 (magenta) — 60,50,100 
C7 (black) - 0,0,100 


Examples 

IRMAP Cl 0,10,0<CR> 

Cl has default HLS parameters 120, 50,100. By entering the command above, the 
<lightness> is changed 10 percent. The new HLS parameters for Cl are then 
120,60,100. Notice that since 0 was entered for the <hue angle> and <saturation> 
parameters, <hue angie> and <saturation> are not changed. The revised parameters 
and a color sample will appear when a new SYSTAT message is displayed. 

IRMAP C2 30,-25,-50<CR> 

C2 has default HLS parameters of 240,50,100. This command will change the <hue 
angle> from 240 to 270 degrees, the <lightness> from 50 to 25 percent, and the 
<saturation > from 100 to 50 percent. 
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MIX Command 

The MIX command provides an alternative to the MAP and RMAP methods of defining the 
color assigned to a given color number. The MIX command combines proportionate 
amounts of red, green, and biue to create one of the 64 possible colors. 

Syntax 

IMIX <Cn> <red> <green> <blue><CR> 
where 

<Cn> is one of the eight color numbers C0-C7. 

<red>, <green >, and <blue> are positive integers from 0 to 100. 

Action 

This command redefines the color Cn by mixing the basic colors of red, green, and blue. 
The <red>, <green>, and <blue> parameters specify the amount of the corresponding 
colors to be MIXed, in percentages of full intensity. Smali changes in the percentages of 
<red>, <green>, or <blue> may not cause the displayed color to change. 

If a SYSTAT message is displayed, it will show the newly MIXed color but the HLS 
parameters will be shown as 0,0,0. 

Examples 

IMIXC2 25,0,100<CR> 

Color C2 will have a <red> component which is 25 percent of its full intensity, no 
<green> component, and a <blue> component which is 100 percent of its full intensity. 

IMIXC2 0,0,0<CR> 

Color C2 is a mixture of red — 0%, green — 0%, blue — 0%. With this mixture, C2 is black. 
IMIX C2 100,100,100<CR> 

Color C2 is a mixture of red — 100%, green — 100%, blue — 100%. With this mixture, C2 
is white. 

Mixes 50,50,0<CR> 

Color C3 will have: <red> and <green> components which are both 50 percent of their 
full intensity, and zero <blue> component. 
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PATTERN Command 

The PATTERN command is used to define a colored pattern for use in vector drawing, 
polygon filling, and so forth. The 4027 can have 120 user-defined patterns in its memory 
at any one time. 

Syntax 

IPATtern <Pn> [<background COL>] <foreground COL> [<value 1 >]... 

[<value 14>] [<foreground color>[<value 1 >].. .[<value 14>]]...<CR> 

where 

< Pn > is one of PO, P1.P119. 

<background COL>, <foreground COL>, and all occurrences of <foreground 
color> are chosen from CO, C1.C7. 

All <value i> parameters are integers from 0 to 255. If less than 14 <value i> 
parameters are specified, the omitted ones default to zero. 

Action 

The pattern Pn is defined by setting the color of each dot in a color cell. If two colors are 
given, the first is the <background color>, and the remainder of the command consists of 
groups that specify a <foreground color> and the dots that are to be made that color. 
Once a <foreground color> is set, all the dots which are designated by the following 
<value number> will be made that color. Sets of dots within each row may be set to 
different colors by giving additional <foreground colors> and specifying the dots to be 
made that color by giving additional <value numbers>. In this manner, it is possible to 
have each of the eight dots in each row be an individual color. 

The dots which are turned on to create the pattern are set by giving a <value number> 
which is an integer between 0 and 255. <value numbers> are decimal equivalents of 
binary numbers and are assigned for each of the 14 rows of the color cell. If a <value 
number> 0 or no <value> is given for any row, the <background color> is displayed. 

Examples 

IPATtern PO C2 C3 0,0,0,0,60,60,60,60,60,60,0,0,0,0<CR> 

Pattern PO will have a <background color> C2, which will be the color for all of the rows 
which have a < value> of 0. Rows 5 through 10, which are given a <value> of 60, will 
have some of their dots turned on in the <foreground color> (C3) as shown. The 
rest of their dots will be color C2. 
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Foreground Background 
Color Color 


1PATP1 C1 C3 7,7,7,7,7,7,7,7,7,7,7,7,7,7 02 
24,24,24,24,24,24,24,24,24,24,24,24,24,24<CR> 

Pattern PI will have a <background color> 01 (default red) which wiil fill the dots not 
designated by the <foreground OOL> parameter. The rightmost three columns of the 
color cell are displayed in color 03 (default blue). Oolumns four and five (counting from 
the right) are displayed in color 02 (default green). The remaining columns have not been 
designated by this command and will therefore appear in the <background color> 01. 

Notice that when a new <foreground color> is given, a <value number> is given for 
each row, starting at row one (the topmost row). The illustration beiow shows the integers 
used, the eight-bit binary equivaient, and the pattern. 
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GRAPHICS 


The 4027 has extensive color graphics capability. It can draw/ several styles of vectors 
(line segments), intermix graphics with text and forms, and store special purpose 
character fonts defined by the user. The 4027 can also draw circles, pies (filled circles), 
and polygons. All these features include color capability. 


THE GRAPHIC COMMANDS 

There are seventeen commands designed for creating color graphic displays on the 4027. 
This section contains a discussion of each of these commands, in the order in which they 
are listed: 


• Graphic 

• Enable 

• Disable 

• Vector 

• RVector 

• Line 

• Poly 

• RPoly 

• Pie 


• Circle 

• Ink 

• String 

• Erase G 

• Shrink 

• Symbol 

• Font 

• DFont 
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GRAPHIC Command 

Graphics are displayed in the 4027 workspace. Before this can be done, the workspace 
must be prepared to display graphs by defining a graphic region. The GRAPHIC command 
is used for this purpose. 


Syntax 

iGRAphic <beg rowxend row>[<beg col>[<end col>]]<CR> 

where all parameters are positive integers designating rows and columns in absolute 
workspace coordinates. Thus <beg row> must be less than <end row>, <beg col> 
must be less than <end col>, and <end col> must be less than or equal to 80. Also, 
<end row> must not exceed <beg row> by more than 53 rows. The default values of 
<beg col> and <end col> are 1 and 80, respectively. 


Action 

This command defines a graphic region in the 4027 workspace and erases all information 
currently stored in this region. The graphic region thus defined consists of rows <beg 
row> through <end row>, and columns <beg col> through <end col> in each of these 
rows. 


Examples 

IGRAphic 1,33<CR> 

Creates a graphic region in the workspace containing columns 1 through 80 of rows 1 
through 33. 

IGRA 1,33,30<CR> 

Creates a graphic region in the workspace containing columns 30 through 80 of rows 1 
through 33. 

The structure of a graphic region is best illustrated by an example. The command 
IGRA 10,19,20,49<CR> 

creates a graphic region which occupies rows 10 through 19, columns 20 through 49 in 
each of these rows. 
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As illustrated in Figure 8-1, this graphic region is 10 cells (character cells) high and 30 
cells wide. Each cell consists of a dot matrix 8 dots wide by 14 dots high. Each dot can be 
turned on (lighted). Various commands discussed in this section create graphic displays 
or display user-defined symbols by turning on patterns of these dots. 



The columns of dots are numbered from left to right across the graphic region, starting 
with 0 for the leftmost column, and from bottom to top, starting with 0 for the bottom row. 

In Figure 8-1, the 240 columns of dots (30 cells, each cell 8 dots wide) are numbered 
from 0 to 239; the 140 rows of dots (10 cells, each cell 14 dots high) are numbered from 
0 to 139. This establishes a coordinate system in the graphic region. For each dot in this 
region there is a pair of numbers: its X- and Y-coordinates. The X-coordinate gives the 
dot’s horizontal position; the Y-coordinate gives the dot’s vertical position. These 
coordinates are used in the VECTOR, POLYGON, PIE, and CIRCLE commands. 

This coordinate system is also used in the RVECTOR and RPOLYGON commands. In 
these commands, however, each coordinate pair is relative to the last coordinate pair 
given in the command. 

It is possible to define more than one graphic region in the workspace. If this is done, new 
graphic commands affect only the graphic region most recently defined. Different graphic 
regions should not overlap. 
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ENABLE Command 

The ENABLE command places the 4027 in the Graphic Input (GIN) mode. This mode is 
used to provide graphic beam position and color information to the host computer. 


Syntax 

lENAble [<count>]<CR> 

where <count> is a positive integer specifying the number of points to be sent to the 
host computer. If <count> is not specified, it defaults to infinity. 


NOTE 

GIN mode may also be initiated by pressing the crosshair key. 


Action 

The ENABLE command causes the terminal to enter GIN mode. When GIN is first 
ENABLEd, the crosshair is displayed at the graphic beam position. The crosshair can then 
be manipulated with the cursor control and home keys. 

When a key other than the crosshair control key is pressed, a report is sent to the host. 
The report is in the form: 

<cmd. chr.> DAT 03, <key>, <x pos>, <y pos> <color>; 
where 

<cmd. chr.> is the current command character. DAT 03 indicates the crosshair 
device. 

<key> is the ASCII decimal equivalent of the key value that generated this report. 

<x pos> is a three-digit number indicating the location of the crosshair with respect 
to the horizontal axis. 

<y pos> is a three-digit number indicating the location of the crosshair with respect 
to the vertical axis. 

<color> is a three-digit number indicating the color of the point at that location. 
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The 4027 remains in GIN mode until one of the following occurs: 

• the crosshair key is pressed. 

• a DISABLE command is sent from the host or typed on the keyboard. 

• the specified <count> number of points and the carriage return have been sent. 
An end-of-line sequence is not sent between each point when multiple points are 
sent. 

Certain characteristics of the graphic beam during GIN mode should be noted. When 
ENABLE is given, the crosshair is displayed at the graphic beam position. If the crosshair 
is moved, the graphic beam is moved to the crosshair position when a key is pressed. 
Also, if INKing is on, a line is drawn from the previous graphic beam position to the 
present crosshair position when a key is pressed. The key normally used to set the 
graphic beam at the position of the crosshair is the pad terminator key. However, pressing 
most of the alpha or numeric keys will have the same result. Keys which, when pressed, 
do not set the graphic beam at the position of the crosshair are the BREAK, CROSSHAIR, 
SHIFT, CONTROL, HOME, TTY LOCK, NUMERIC LOCK, and COMMAND LOCK OUT keys. 


Examples 

lENAble <CR> 

Places the 4027 in GIN mode and sets the crosshair at the graphic beam position. 


!ENA5<CR> 



A crosshair appears in the workspace 
when the 4027 is ENABLED. 


Places the 4027 in GIN mode for the specified number of points (5) and sets the 
crosshair at the graphic beam position. An end-of-line sequence is sent, after five reports 
have been sent, which causes the crosshair to leave the screen and the 4027 to leave 
GIN mode. 
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DISABLE Command 

Syntax 

IDISAble <CR> 


Action 

The DISABLE command removes the 4027 from GIN mode. The crosshair is removed from 
the graphic area and the crosshair control keys return to controlling the alpha cursor. An 
end-of-line sequence is sent to the host as the terminator of the GIN messages, if any 
have been sent. 
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VECTOR Command 

When a graphic region of suitable size has been defined, vectors (line segments) can be 
drawn in the graphic region using the VECTOR command. 


Syntax 

iVECtor <X0><Y0><X1 ><Y1 >[<X2><Y2> ... <Xn><Yn>]<CR> 
where all <X> and <Y> parameters are positive integers. 


Action 

This command draws a vector from the point with graphic coordinates (<X0>, < Y0>) to 
the point with coordinates (<X1 >, <Y1 >). If additional pairs of coordinates are 
specified, additional vectors are drawn from (<X1 >, <Y1 >) to (<X2>, <Y2>), from 

(<X2>, <Y2>) to (<X3>, <Y3>).and finally from (<X(n-1)>, <Y(n-1)>) 

to(<Xn>, <Yn>). All vectors are drawn in the color currently defined by the COLOR 
command. 

The <X> and <Y> coordinates are graphic region coordinates. If the value of <X> or 
<Y> is not within the graphic region, the vector is “clipped;” that is, a line is drawn to 
the edge of the graphic region in the current direction. If another vector is drawn after this, 
the new vector is also clipped as it comes back into the window. 

A \fLC'hor Was bCAn tts* position vs 

tWit poii^t dVAMJn. 
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Example 

Suppose you have used the !GRA 10,19,20,49<CR> command to define the 240 X 140 
graphic region described earlier. The command 

!VEC 1 20,120 91,30 168,85 72,85 149,30 1 20,120<CR> 

creates the following display. (Axes are not shown on the display.) Note that, since either 
a space or a comma serves as the separator, we have alternated these to emphasize the 
VECTOR coordinate pairs. 


Y-AXIS 


( 120 , 120 ) 

\ 



- ► X-AXIS 

!VEC 1 20,1 20,91,30,168,85,72,85,149,30,120,120 

2402-13 


Figure 8-2. The VECTOR Command. 
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RVECTOR (Relative Vector) Command 

It is possible to draw vectors by specifying relative coordinates — that is, coordinates 
relative to the last graphic beam position. This is done using the RVECTOR command. 

Syntax 

IRVEctor <rel XOxrel YOxrel X1 xrel Y1 > 

[<rel X2xrel Y2> ... <rel Xnxrel Yn>]<CR> 

where <rel X> and <rel Y> are integers, not necessarily all positive. The parameters 
are separated by spaces or commas. 


Y-AXIS 



!RVE 0, 55,-29,-90,77,55,-96,0,77,-55,-29,90<CR> 

2402-14 


Figure 8-3. The RVECTOR Command. 
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Action 

This command draws one or more vectors in the graphic region, as does the VECTOR 
command. The pair <rel X0>, <rel Y0> specifies coordinates relative to the current 
graphic beam position. Each succeeding pair of <rel X>, <rel Y> parameters specifies 
new coordinates relative to the preceding coordinate pair. All vectors are drawn in the 
color currently defined by the COLOR command. 


Example 

Suppose that the current graphic beam position is at the point with absolute workspace 
coordinatesd 20,65). The command: 

IRVE 0,55 -29,-90 77,55 -96,0 77,-55 -29,90<CR> 

draws the star in Figure 8-3. It is the same figure drawn by the earlier VECTOR command, 
but now each pair of coordinates given is relative to the preceding pair of coordinates. 


As in the VECTOR command, if a pair of coordinates specifies a point outside the graphic 
region, the 4027 will draw the vector only to the edge of the graphic region where it will be 
terminated or “clipped.” The next line to be drawn will be drawn as though the entire 
vector was present. The ciipping action has no effect on subsequent vectors. 


@ 
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LINE Command 

The 4027 can draw different styles of vectors. The style of vector is selected with the 
LINE command and will be drawn in the current vector color by the VECTOR command. 

Syntax 

ILINe [<line type>]<CR> 
where <line type> must be one of the following: 

• A digit from 1 to 8, inclusive 

• The letter P 

• The letter E 

If <line type> is not specified, it defaults to one. 

Action 

This command sets the type of line used to draw vectors in subsequent VECTOR, 
RVECTOR, and CIRCLE commands. Line type 1 is a solid line, the default line type. Line 
types 2 through 8 are various styles of dashed lines. Line types 1 through 8 are shown in 
Figure 8-4. 



Line type P causes subsequent VECTOR and RVECTOR commands to plot isolated points 
rather than connect the points with line segments. 

Line type E causes subsequent VECTOR and RVECTOR commands to draw vectors in the 
background color which effectively “erase” existing vectors. However, if a line that 
crosses a polygon is erased in this way, it will leave a background color line across the 
polygon. 


@ 


4027 PROGRAMMER’S 


8-11 









GRAPHICS 

POLYGON COMMAND 


POLYGON Command 

A large number of shapes and panels may be drawn in color by the 4027 using the 
POLYGON command. 


Syntax 

IPOLygon <X1 ><Y1 ><X2><Y2><X3><Y3>[...<Xn><Yn>]<CR> 
where 

<X1 > is an integer indicating a point on the horizontal axis which will be one of the 
coordinates for one vertex of the polygon. 

< Y1 > is an integer indicating a point on the vertical axis which will be the second 
coordinate for one vertex of the polygon. Additional parameters define the 
succeeding vertices of the polygon. A minimum of 3 vertices are necessary to form a 
polygon. 


Action 

This command draws a polygon whose vertices are defined by the given parameters. This 
polygon Is filled in with the current color (as defined by the COLOR command). 
Boundaries of polygons are drawn in the current line type, as defined by the LiNE 
command. The vertices are given as in the VECTOR command; if the last vertex is not the 
same as the first vertex, then a closing edge is automatically drawn. If any edges cross, 
the polygon will still be filled correctly. 

Since a maximum of 53 lines may be allotted to the graphic region, the largest possible Y 
axis coordinate is 752 (14 X 53 = 752). 

Refer to the GRAPHIC command discussion for further explanation of the graphic region 
coordinate system. 
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Example 

IPOLygon 100,100,200,100,200,200,100,200<CR> 

Creates a polygon designated by the given vertices in the current color as shown below. 


Y-AXIS 

t 

( 100 , 200 ) ( 200 , 200 ) 



( 100 , 100 ) ( 200 , 100 ) 


♦►X-AXIS 


IPOL 100,100, 200,100, 200, 200, 100, 200<CR> 

2657-11 
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RPOLYGON (Relative Polygon) Command 

The 4027 can draw polygons using relative coordinates (as in the RVECTOR command). 

Syntax 

RPOLygon <X1 ><Y1 ><X2><Y2><X3><Y3>[...<Xn><Yn>]<CR> 
where 

<X1 > and < Y1 > are coordinates relative to the current position of the crosshair 
and define the first point of the polygon. 

<Xn> and <Yn> are subsequent coordinates which define the other vertices of 
the polygon relative to the last given pair of coordinates. 

Action 

This command creates a filled polygon in the current vector and boundary color as does 
the POLYGON command. But the vertices are given in relative coordinates, as in the 
RVECTOR command. If the last vertex Is not the same as the first, a closing edge is 
automatically created. Like the POLYGON command, the resulting filled area covers 
anything below it. If polygons overlap, the last one created is the one displayed in the 
overlapping area. 


Y-AXIS 


CROSSHAIR — ! 



THIRD VERTEX (-50,50) 


■ SECOND VERTEX (50,50) 


START (0,0) IS AT LOCATION 
OF THE CROSSHAIR. 


X-AXIS 


IRPOL 0,0 50,50 -50,50<CR> 


2657-12 


Figure 8-5a. An RPOLY Command Using 0,0 as the First Coordinate Pair. 
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Example 

IRPOLygon 0,0.50,50,-50,50<CR> 

Creates a triangle at the location of the crosshair in the current vector and boundary 
colors, as shown in Figure 8-5a. 

IRPOL 150,0,50,50,-50,50<CR> 

Creates a triangle. Its first coordinate pair is 1 50 points to the right of the crosshair 
position on the X axis. Subsequent vertices of the triangle are drawn relative to the 
position designated by the previous coordinate pair. Refer to Figure 8-5b. 


Y-AXIS 


I 





150 

POINTS 



VERTEX (-50,50) 


SECOND VERTEX 
(50,50) 


START (150,0) 


X-AXIS 


IRPOL 150,0 50,50 -50,50<CR> 


2657-13 


Figure 8-5b. An RPOLY Command Using 1 50,0 as the First Coordinate Pair. 
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PIE Command 

The 4027 can draw filled circles, circle sectors, or equilateral polygons using the PIE 
command. 


Syntax 

!PIE <radius> [<start angle>] [<end angle>] [<increment angle>]<CR> 
where 

<radius> is a positive integer representing the radius of the pie or polygon in raster 
units. A raster unit is one dot within a character cell. Refer to the GRAPHIC command 
(in this section) for further explanation of dots and character cells. 

<start angle> is a positive or negative integer which states the angle at which the 
first radius is drawn. 

<end angle> is a positive or negative integer which states the angle at which the 
last radius is drawn. 

<increment angle> is a positive integer which represents the angle between points 
on the circumference that become vertices of a polygon. 


Action 

The PIE command causes a pie shape to be drawn, centered at the current crosshair 
position. The pie has a <radius> of the specified number of raster units and is filled with 
the current vector color and outlined in the current boundary color from the <start 
angle> to the <end angle>. If the <start angle> and <end angle> are not given, 0 and 
360 degrees are the default values and a complete pie is drawn with the specified 
<radius>. 

If <increment angle> is given, the PIE command creates a polygon with vertices every 
< increment angle> degrees. These points are joined and become the vertices of a 
polygon. The default value for <increment angle> is 4 degrees. A polygon drawn with 
vertices this close together looks like a circle. 

All angles are measured with 0 degrees as the point of reference. Zero degrees is the 
horizontal line segment which extends from the center point to the point on the right side 
of the graphic area. Angle values increase in a direction moving counterclockwise. 
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Examples 

!PIE 100 0 270<CR> 

Causes a pie to be drawn as shown below. The <radius> is 100 raster units, <start 
angle> is 0 degrees, and <end angle> is 270 degrees. 



IPIE 100 0 270<CR> 


2667-14 


IPIE 100 0 360 45<CR> 

This command draws a polygon as shown below. The <radlus> is 100 raster units, 
<start angle> is 0 degrees, and <end angle> is 360 degrees. Since the <increment 
angle> of 45 degrees has been given, the pie is drawn as a polygon with 8 equal sides. 
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!PiE 100 0 360 90<CR> 

When this command is given the polygon shown below is drawn in the current boundary 
color and filled in the current vector color. The <radius>, <start angle>, and <end 
angle> are the same as in the previous example. With the <increment angle> set at 90 
degrees, a square polygon is drawn which is rotated 45 degrees from the X axis. 



8-18 


4027 PROGRAMMER’S 



GRAPHICS 

CIRCLE COMMAND 


CIRCLE Command 

The CIRCLE command is used to create circles, circle sectors, and equilateral polygons, 
just as the PIE command. These shapes, however, are not filled; Instead just the boundary 
is drawn in the current color. 


Syntax 

ICIRcle <radius> [<start angle>] [<end angle>] [<increment angle>]<CR> 
where 

<radius> is a positive integer representing the radius of the circle or polygon in 
raster units. 

<start angie> is a positive or negative integer which states the angle at which the 
first radius of the circle will be drawn. 

<end angle> is a positive or negative integer which states the angle at which the 
last radius of the circle will be drawn. 

<increment angle> is a positive integer which represents the number of degrees 
between the vertices of the polygon. 


Action 

The CIRCLE command creates various shapes in the same manner as the PIE command. 
The CIRCLE command causes a shape to be drawn around the beam position which, 
unlike the PIE command, is not filied with the current vector color. Only the boundary of 
the figure is made the current color. 

The circle (or polygon) will be drawn from the <start angle> to the <end angle> at a 
radius of <radius> raster units, if the <start angle> and <end angle> are not given, 
they default to 0 and 360 degrees, respectively. 

If <increment angle> is given, the CIRCLE command will mark vertices at intervals of 
<increment angle> degrees. The vertices then are joined to form a polygon as in the PIE 
command. Default value for <increment angle> is 4 degrees. 

All angles are measured with 0 degrees as the point of reference. Zero degrees is the 
horizontal line segment which extends from the center point to the right side of the 
graphic area. Angle values increase in a direction moving counter clockwise relative to 
zero degrees. 
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Examples 

ICIRcle 100 0 360<CR> 

!CIR 100<CR> 

Creates a complete circle in the current vector color with a <radius> of 100 raster units, 
as shown below. 



!CIR 100 0 360 45<CR> 

Creates a polygon in the current vector color with a <radius> of 100 raster units. As 
shown below, including the < increment angle> of 45 degrees causes an eight-sided 
polygon to be formed. <Start angle> and <end angle> must be given when <increment 
angle> is used. 
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!CIR 100 90 360<CR> 


Creates a sector of a circle with a <radius> of 100 raster units from the <start angle> 
of 90 degrees to the <end angle > of 360 degrees, as shown below. 
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INK Command 

The INK command enables the drawing of lines between points in the graphic area 
without typing in coordinates. The 4027 must be in the GIN mode to INK. 

Syntax 

iINK [Yes|No]<CR> 

If no parameter is specified, Yes is assumed. 


Action 

When the INK or INK YES command is given, the 4027 can draw lines from the present 
crosshair iocation to the previous location without designating the coordinates as in a 
VECTOR or RVECTOR command. The 4027 must be ENABLED by giving the ENABLE 
command or pressing the zero/crosshair key. After this has been done, pressing the pad 
terminator key or any other non-cursor moving key causes a line to be drawn from the 
present position of the crosshair to the previous position. 

The INK NO command turns INKing off. 


Example 

!INK Yes<CR> 

Refer to Figure 8-6. When drawing a line from crosshair position one to position two, 
position one must first be established by moving the crosshair to the desired location and 
pressing the pad terminator key. Remember that the crosshair is displayed by giving the 
ENABLE command or pressing the crosshair key. When the crosshair first comes up, if 
INKing is already on, a line is drawn from the previous beam position to the crosshair 
position when the pad terminator key is pressed. 
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Figure 8-6. Drawing a Line in INK mode. 


After the position of the crosshair has been established, give the INK command. Then, 
each time the crosshair is repositioned and the pad terminator key is pressed, a line is 
drawn between the present location of the crosshair and the previous one. Lines are 
drawn in the current vector color. If no color has been specified, lines are drawn in color 
number CO (default white). 

!INK No<CR> 

The INKing process is terminated. If INKing is off, then no vectors are drawn when points 
are set in GIN mode. 

If an ENABLE command for X points is given, after X points are entered, the crosshair 
goes down and INKing appears to terminate. However, INKing is still in effect and 
additional vectors will be INKed if the zero/crosshair key is pressed, returning the 
crosshair to the graphic region. INKing is terminated only by giving the INK NO command. 
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STRING Command 

Text may be entered in a graphic region directly from the keyboard or by using the 
STRING command. The STRING command allows text to be positioned relative to the 
displayed graphics using graphic coordinates. 


Syntax 

ISTRing <text><CR> 
where <text> may be: 

1. One or more delimited ASCII strings. 

2. A sequence of ASCII Decimal Equivalents. 

3. Any combination of 1 and 2. 

The string defined by <text> should not contain the command character. 


Action 

This command inserts the string defined by the <text> parameter into the graphic 
region. The first character defined by <text> is displayed in the character cell containing 
the graphic beam. Succeeding characters of <text> are displayed in succeeding 
character cells. Any vectors or characters that were previously displayed in the character 
cells where <text> is inserted are no longer visible, since each character of <text> fills 
an entire character cell. 


Example 

!STRing/Triangle/<CR> 

where “Triangle” is a delimited ASCII string which will be displayed at the position of the 
graphic beam. 
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GRAPHIC 1,35 
VECTOR 0,0 300,0 
VECTOR 120,80 
STRING "Triangle" 


150,200 0,0 
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ERASE G Command 

When the information displayed in a graphic region is no longer needed, it can be deleted 
in one of two ways. You can delete the graphic region and ali information stored in it from 
the workspace display list. You can also erase the graphic information but leave the 
graphic region defined to display new graphic information. 

To delete the graphic region from the display list, give the ERASE WORKSPACE 
command. The graphic region, along with all other information in the workspace, is 
deleted from the display list. No further graphic commands can be executed until a new 
graphic region is defined by a GRAPHIC command. 

If you wish to reuse the same graphic region, the ERASE G command is used. The ERASE 
G command can include a color number or pattern number which will cause the graphic 
area to be flooded (erased) with the specified color or pattern. 


Syntax 

lERAse [G [raphics] [<color number>|<pattern number>]]<CR> 


Action 

This command causes the graphic area to be erased. If the parameters include a color 
number (C0-C7) or pattern number (P0-P119), the color or pattern becomes the 
background color. The current vector and panel drawing color is not changed. The ERASE 
GRAPHICS command does not reallocate the graphic memory cells at the top of Font 31. 


NOTE 

The ERASE command can also be used to erase the contents of the 
workspace or monitor. Refer to the Controlling the Display section for 
details. 
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Examples 

!ERAG<CR> 

Erases the contents of the graphic area containing the graphic cursor. 
!ERAGC1<CR> 

Erases the contents of the graphic area with color C1. 
lERAG P1 <CR> 

Erases the contents of the graphic area with pattern P1. 
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SHRINK Command 

When using 4010-style graphics it is necessary for the 4027 to alter the coordinates of 
graphic information in its display list. 

The 4027 can accept 4010-style graphic commands from a host computer. In 4010-style 
graphic commands, the X-coordinates can be as great as 1023. The X-coordinates in a 
4027 graphic commands should not exceed 639 (in a graphic region occupying all 80 
columns). It is necessary, therefore, to scale incoming 4010-style graphic commands for 
display in the 4027 graphic region. (See discussion of 4010-style graphics in this 
section.) 


Syntax 

ISHRink [Yes | Hardcopy | Both | No] < CR > 
The default parameter is Yes. 


Action 

SHRINK YES. This command causes the 4027 to “shrink” X- and Y-coordinates in 
subsequent VECTOR, RVECTOR, POLY, RPOLY, CIRCLE and PIE commands, multiplying 
them by a factor of approximately 5/8. This accommodates the 4027 to the range of 
possible coordinates in 4010-style graphics commands. 

To use the 4027 to execute a 4010-styie graphic command file, first dimension the 
graphic region to hoid 35 rows of 80 coiumns. (IGRA 1,35,1,80 or IGRA 10,44 are two 
GRAPHIC commands which do this.) Then give a SHRINK YES command to put the 4027 
in graphics shrink mode. 


NOTE 

SHRINK HARDCOPY and SHRINK BOTH commands are included only for 
compatibility with programs written for the 4025. These commands are not 
recommended for programs written for the 4027. 


SHRINK NO. This command removes the 4027 from shrink mode. 
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EFFECTS OF A GRAPHIC REGION 

The presence of a graphic region affects the action of some of the 4027 commands and 
keys, summarized here: 

DELETE CHARACTER: Inside a graphic region, the character is replaced by a space. 

DELETE LINE: In a line which passes through a graphic region, oniy characters outside 
the graphic region are deleted. Information inside the graphic region is not deieted. 

ERASE & SKIP: In a line that passes through a graphic region, only characters outside 
the graphic region are deieted. 

ERASE WORKSPACE: This erases the entire workspace, inciuding the graphic region 
definition. A new GRAPHiC command must be given before new graphics can be 
displayed. 

CURSOR MOVEMENT AND TYPING: The ASCII keys, the cursor movement keys and 
commands, and the scrolling keys and commands are not affected by the presence of the 
graphic region, if the cursor is moved into a graphic region and a character typed on the 
keyboard, that character replaces graphic information previously stored in the character 
cell. Entering GIN mode causes the cursor movement keys to control the movement of the 
crosshair instead of the cursor. 

FORM FILLOUT MODE: All locations within the graphic region are protected in form 
fillout mode. If a graphic region is less than 80 columns wide and no form exists in the 
side region(s), the area to the left of the form is unprotected (text may be entered) but all 
other areas outside the form are protected and text may not be entered in them. To 
prevent text from being entered into the unprotected area of the field, expand the graphic 
area so that it will begin at column 1. 

ATTRIBUTE CODES: Inside a graphic region, the 4027 inserts only font attribute codes 
in the display list. All other attributes are ignored. Any visual attributes (enhanced, etc.) 
which are in effect at the left edge of the graphic region affect the entire row of character 
cells running through the graphic region. Logical attributes and font codes in effect at the 
left edge of the graphic region do not affect the graphic region itself, but characters to the 
right of the graphic region are given these same font and logical attributes. 

THE SEND COMMAND: Graphic information in a graphic region is not transmitted by the 
SEND command. Every character cell containing graphic information is transmitted as an 
ASCII space. Text information is sent, however. 
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If you do a SEND operation to the computer, then SEND back from the computer to the 
terminal, you obtain the display in Figure 8-9. No information generated by graphic 
commands was sent to the computer. The display in Figure 8-9 is what is stored in the 
computer. 
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OUTLRVS FOR TRRNSPORTRTION 


TOTAL 

HIGmnVS AND OTHER TRANSPORTATION 
NASS TRANSIT ATf) RAILROADS 
HATER 


68 69 70 71 72 73 74 75 76 77 78 79 

FISCAL YERRS 

( 2402 ) 2667-22 


Figure 8-9. A Graphic Display After the SEND Command. 
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4010-STYLE GRAPHICS ON THE 4027 

The 4027 with standard Graphics Memory, accepts 4010-style graphic commands when 
these commands are sent from the host. (The 4027 does not accept 4010-style graphic 
commands entered on the keyboard.) 4010-style graphics are characterized by 
addressable screen coordinates and the use of ASCII characters to encode these 
addresses. 

To enable the 4027 to respond properly to 4010-style graphic commands, issue the 
commands 

IGRAPHIC 1,35<CR> 

!SHRINK<CR> 

These set up a graphics region which is correctly proportioned to display 4010-style 
graphics. Specifically, the viewable graphic region is approximately 640X by 490Y, in 
4027 workspace coordinates (1024X by 780Y in 4010 coordinates). (See the SHRINK 
command discussion earlier in this section.) 

In 4010-style graphics, certain control characters are interpreted by the terminal as 
graphic commands. The following 4010-style commands from the host cause the 4027 to 
change operating modes: 

1. The GS command places the 4027 in 4010-style graph mode. 

2. The US command exits the 4027 from graph mode and positions the cursor at the 
character cell containing the graphic beam. 

3. The ESC command notifies the 4027 that the next character should be 
interpreted as a command. 

4. The ESC-Form Feed command erases the graphic region if the terminal is not in 
graph mode. 


Addressing the Graphic Beam 

The graphic beam is moved to a point in the graphic region by sending to the terminal the 
binary equivalents of the Y address and the X address (4010 coordinate addresses) of 
the point. Each binary equivalent is separated into two parts: the five most significant bits 
and the five least significant bits. The address 205Y,148X translates to 0011001101Y, 
00100101OOX (binary). The 0011001101Y becomes 00110 HiY and 01101 LoY; the 
00100101 OOX becomes 00100 HiX and 10100 LoX. In graph mode, these bytes cause 
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the beam to be moved to the 205Y,148X position in the graphic region. To be sent to the 
4027, these bytes must be encoded as ASCII equivalents. The 00110 HiY bit is encoded 
as an ASCil symbol, which has binary representation 0100110. The first two bits, 01, 
instruct the terminai that this is a HiY address. The last five bits, 00110, form the HiY 
segment of the Y address 0011001101.205Y, 148X is encoded as “&m$T.” Appendix C 
is a Coordinate Conversion Chart for encoding X- and Y-coordinates as ASCII characters 


Graph Mode Memory 

When an address is sent to the terminai, the HiY, LoY and HiX bytes are stored in a 
register, if the next address sent to the terminai repeats some of these bytes, they need 
not be retransmitted. LoX must always be sent, since the command is not executed untii 
LoX is received. Even if the 4027 ieaves graph mode and reenters it iater, these three 
bytes are retained. The following tabie shows which bytes must be sent in response to 
specific byte changes. 


Table 8-1 

4010-STYLE GRAPHICS REQUIRED BYTE TRANSMISSIONS 


Bytes 

Which 

Change 

Bytes which must be transmitted 

Hi Y 

LoY 

Hi X 

LoX 

Hi Y 

# 



# 

Lo Y 


* 


* 

Hi X 


* 


* 

Lo X 




* 


When the 4027 exits 4010-style graph mode, the communications port is returned to the 
portion of display memory it was in before entering graph mode (workspace or monitor). 

For a complete discussion of 4010-style graphics, see the 4010 Series documentation. 
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ALTERNATE CHARACTER FONTS 

The 4027 graphics memory may be used to store alternate character fonts, defined by the 
user for special purposes. 

With its full 192K of graphics memory (Option 29), the 4027 can accommodate up to 32 
different fonts, each containing up to 128 characters. Thirty-one of these fonts may be 
user-defined. (The standard font is Font 0 and cannot be modified by the 4027 operator 
or by the computer.) In addition to the standard font, two other predefined fonts are 
available: Ruling Characters (Option 32) and Math Characters (Option 34). 


NOTE 

Font 31 is used to store user-defined patterns. A FONT 31 command wiii 
cause an error condition. 


Alternate character fonts are defined by the FONT command or on a character by 
character basis with the SYMBOL command. 
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SYMBOL Command 

Syntax 

ISYMbol <number> <font>[<background color no.>] [<foreground color no.>] 
[<value 1 >]... [<value 14>][<foreground color no.>][<value 1 >]... 

[<value 14>]]<CR> 

where 

<number> is an integer between 0 and 127, inclusive, or any of the ASCII 
characters. 

<font> is an integer between 1 and 31, inclusive. 

<background color no.> is a color number, C0-C7, which designates the color of 
the dots which will not be a part of the symbol. 

<foreground color no.> Is a color number, C0-C7, which designates the color of the 
dots which form the symbol. 

Each <value n> is an integer from 0 to 255 which specifies which dots in a 
particular row will be the foreground color. 

The <font> parameter must specify a character font for which graphics memory is 
installed. (The operator can discover which character fonts have graphics memory 
installed with the GTEST command, discussed in the System Status and Initialization 
section.) Each < value n> parameter defaults to zero. 


Action 

This command defines a symbol in character font <font>. The <number> parameter is 
the ASCII decimal equivalent of some ASCII character. The ASCII character itself may be 
used. The symbol defined by this command is displayed whenever the specified ASCII 
character is entered in a field with font attribute <font>. 

The symbol is defined by specifying which dots in the 8 x 14 character cell matrix are 
lighted in the <foreground color> when the symbol is displayed. Each <value n> 
parameter is converted into an 8-bit binary equivalent. The zero/one pattern of this binary 
equivalent determines which of the eight dots in the n-th row of the character cell are 
lighted in the <foreground color> when this character is displayed. 

Rows and dots within a row which are not used to form the symbol will be displayed in the 
<background color> or, if none is specified, will default to color C7 (default black). 
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Example 

The command 

!SYM 97,30,C1,C2,0,0,0,0,2,52,72,72,52,2,0,255 <CR> 
or 

!SYM a,30,C1 ,C2,0,0,0,0,2,52,72,72,52,2,0,255<CR> 

defines character 97 of font 30. The number 97 is the ASCII Decimal Equivalent of the 
ASCII character “a”. When the “a” character is entered in a field with font attribute 30, the 
symbol defined by this command is dispiayed. The symboi is displayed in color C2 and all 
dots which are not used to form the symbol are displayed in the <background color> C1. 
Figure 8-10 illustrates this symbol and how the SYMBOL command defines it. 
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< Background Color> 


Symbol Area is 
< Foreground Color> 


( 2402 ) 2657-23 


Figure 8-10. A User-Defined Symbol. 


If one wishes to clear symbol 97 from user-defined font 30, the command 
!SYM 97,30,C7<CR> 

is given. All rows in the character cell matrix are set to zero, and this symbol is displayed 
as a space, with all matrix dot color C7. 
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FONT Command 

Syntax 

IFONT [<hardware font>] <font number> [<background color>] [<foreground 
color>]<CR> 

where 

<hardware font> is the number of the font to be copied. Default is the regular ASCII 
font, font 0. 

<font number> is an integer between 1 and 31 which represents some font in 
graphic memory. 

<background color> is the color or pattern of the background. 

<foreground color> is the color or pattern for the characters. 

NOTE 

Font 31 is reserved for user-defined patterns set by the PATTERN 
command. Font 31 is illegal and if used an error condition will occur. The 
terminal must be powered off or RESET to remove the error condition. 


Action 

This command copies the < hardware font> into the given font, if it exists, in the given 
colors. If the <hardware font> is not specified, the regular ASCII font (font 0) is used. 
This entry is only valid if the optional Character Set Expansion board (Option 31) is 
installed. The two color numbers specify the colors to be used for background and 
foreground. They may be either a color number (C0-C7) or a pattern number (P0-P119). If 
the colors are omitted they default to the default foreground and background colors (CO 
on C7). Fonts should be defined before drawing graphics to avoid altering the graphic 
area. 

The ATTRIBUTE command is used to display the font at the position of the alpha cursor. 
Refer to the Forms and Form Fillout section for information describing the ATTRIBUTE 
command. 

Example 

IFONt 0,30,C1,C4<CR> 

Copies the hardware font (0) into font 30 in <background color> Cl and <foreground 
color > C4. 
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DFONT (Delete Font) Command 

The graphics memory used to store symbol definitions in a user-defined character font 
can be released for another use by giving the DFONT command. 


NOTE 

Font 31 should be deleted with care. Font 31 is used to store patterns 
defined by the PATTERN command. Deleting Font 31 destroys any stored 
patterns. 


Syntax 

IDFOnt <font><CR> 

where <font> is an integer between 1 and 31, inclusive. 


Action 

The DFONT command deletes the symbol definitions in the programmable font. The space 
may be used for graphics when the font has been deleted. When the Character Set 
Expansion board (Option 31) is installed, the ATTRIBUTE command allows specification 
of a font number. Deleting font 31 does not affect the top eight characters. This allows the 
user to reuse the low characters, but not disturb the palette of possible vector and panel 
colors. 


Example 

The command 

!DFO 30<CR> 

Allows memory used to store symbol definitions now to be used to store graphics or 
another character set. 
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FORMS AND FORM FILLOUT 


From the operator’s viewpoint, a form consists of several lines of text displayed in the 
workspace and formatted in a particular way. A form is divided into blanks areas, which 
the operator fills in, and labets, which identify the type of data to be entered in each blank. 
There may also be horizontal and vertical ruling lines to emphasize the structure of the 
form. The operator fills in the blanks with appropriate data and sends this data to the 
computer for storage or processing. 

A sample form used to store a customer's name and address is shown in Figure 9-1. 
the blanks shaded gray. In typical applications, these blanks could be spaces or colored 
areas on the screen. 


Customer 

's Name 



Street 

Address 




City 




State 

ZIP 





2402-7 


Figure 9-1. Sample Form. 


FORM FILLOUT MODE 

A form is filled out and the data in the form sent to the computer while the 4027 is in form 
fillout mode. 

Form fillout mode has several features designed to make it easy to fill out and process 
forms. 

• Data can be entered only in the blanks of the form. These blanks are called 
unprotected fields. If the operator attempts to enter a character in a protected 
field, the terminal bell sounds and the character is inserted in the next 
unprotected field in the form. 
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• Several keys on the keyboard behave differently when the keyboard types into the 
workspace. The TAB key moves the cursor to the beginning of the next 
unprotected field of the form. The BK TAB key moves the cursor to the beginning 
of the current field. The HOME key moves the cursor to the beginning of the first 
unprotected field in the form, rather than to coiumn 1 of row 1 of the workspace. 
The ERASE key erases only the data in the unprotected fields; protected fields are 
not erased. 

• Several of the 4027 commands have effects other than the usual ones. When the 
computer types into the workspace, the TAB, BACKTAB, and ERASE commands 
have the same effects as the corresponding keys. The editing commands also 
behave differently. These differences are detailed, command by command, 
throughout this section and later sections. 

A typical form fillout application includes the following steps; 

• Insure that the terminal is not in form fillout mode. 

• Display the form in the 4027 workspace. Either the operator creates the form from 
the keyboard or, more often, a stored form is sent from the computer or tape unit to 
the workspace. Both processes are the same from the terminal’s viewpoint. 

• Put the terminal into form fillout mode. 

• Fill out the form. 

• Send the data in the form to the computer (or a printer, a tape unit, or a hard copy 
unit). 

• Erase the unprotected fields of the form and fill it out again; then send the new 
data in the form to the computer. Repeat this process as long as necessary. 

• When the form is no ionger needed, remove the terminal from form fillout mode 
and erase the form itself from the screen. 

The FORM command is used to place the 4027 in form fillout mode and to remove it from 
form fillout mode. 
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FORM Command 

Syntax 

!FORm [ Yes|No]<CR> 

If no parameter is specified, Yes is assumed. 

Action 

If Yes is specified, the 4027 is placed in form fillout mode. If No is specified, the 4027 is 
removed from form fillout mode. 


Examples 

!FOR<CR> Places the 4027 in form fillout mode. 

IFOR Y<CR> 

IFORM YES<CR> 

IFOR N<CR> Removes the 4027 from form fillout mode. 

IFORM NO<CR> 
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CREATING A FORM 


From the 4027’s viewpoint, there is more to a form than meets the eye. Consider the 
sample form in Figure 9-2. This form consists of several lines of text. Each line is divided 
into one or more sections called fields; each field is divided into individual character 
positions. 



Figure 9-2. The Parts of a Form. 
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CREATING A FORM 


To display a form, the 4027 stores the information which defines the form in the portion of 
memory called the workspace display list. In addition to the characters which are 
displayed on the screen, the display list includes markers which are not displayed. These 
markers are of two types: 


• End-of-line markers which indicate where one line of text ends and the next 
begins. 

• Markers called attribute codes. Attribute codes divided a line into fields and 
determine the properties, or attributes, of those fields. 

The fourth line of the sample form appears on the screen as follows: 



■ 

^ 1 btrect Haaress 

D 

>402-20 


To the workspace display list, however, the following information is stored: 



To create a form you must complete the following steps: 

• Decide what each line of the form is to look like—what attributes each field will 
possess; what text, if any, will be printed in the protected fields. 

• Attach attribute codes to each field so that when the 4027 displays the form, each 
field will have the desired attributes and the form, as a whole, will have the desired 
appearance. 

• Type desired text into protected fields. 
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FIELD ATTRIBUTES AND FIELD ATTRIBUTE CODES 

There are three classes of field attributes: 

• Character font attributes: font zero, font one, font two, etc. 

• Logical attributes: alphanumeric, numeric, protected, and protected modified. 
Alphanumeric and numeric denote unprotected fields into which the operator can 
enter data. 

• Visual attributes: the characters and background may be assigned any of the 
color numbers (C0-C7). Characters and background colors may be inverted and 
also made to blink between colors. 4025-style visual attributes (standard, 
enhanced, inverted, and underscored) may also be used. 

Font Attributes 

A 4027 font attribute is an integer between 0 and 31, inclusive. The integer designates 
the character font from which characters are selected for display in the field. The default 
font attribute is 0. Font 0 is called the standard font and consists of the 128 characters of 
the ASCII code. Font 1 is always the Ruling Characters font (Option 32); Font 3 is the 
Math Characters font (Option 34) if it is installed. On the 4027, other fonts may be 
determined by ROMs inserted in the Character Set Expansion Board (Option 31), or may 
be defined by the user with SYMBOL and FONT commands which are described in 
the Graphics section. 


NOTE 

Font 31 is used to store user-defined patterns. A FONT 31 command (see 
Graphics section) causes an error condition. 


If a font attribute is specified for which no character font is defined, each character in the 
font is dispiayed as a rectangle with ali the dots in that character cell matrix turned on in 
random fashion. 


NOTE 

Font attributes in the display list affect the display, whether the terminal is 
in form fillout mode or not. A field with font attribute 1, for example, 
displays characters from font 1 at all times (assuming Option 32 is 
present). 
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Logical Attributes 

The logical attributes which a field can possess are as follows: 


Symbol Used 

Attribute 

Meaning 

A 

Alphanumeric 

The default logical attribute. Specifies an alphan¬ 
umeric unprotected field into which any alphanu¬ 
meric character may be entered. 

N 

Numeric 

Specifies a numeric unprotected field. In form 
fillout mode, only characters with ADEs 32-63 
can be entered in a numeric field. (This includes 
the numerals 0-9, and most punctuation sym¬ 
bols.) 

P 

Protected 

Specifies a protected field. In form fillout mode, a 
protected field cannot be typed into or erased. 


Note that the fields of the form to be filled in by the operator must be unprotected fields, 
with logical attributes A or N; labels and areas in which the operator is not to type should 
be protected. 

Each field possesses one of these logical attributes. In addition, any field may possess 
the logical attribute M, for “modified.” The SEND MOD command sends to the computer 
the data in those, and only those, fields which have been flagged as “modified” with the 
logical attribute M. (See the discussion of the SEND command later in this section.) 

A field may be flagged as “modified” in either of two ways: 

• When the data in any unprotected field is changed, the terminal automatically 
attaches the logical attribute M to that field. The next SEND MOD command sends 
the data in that field to the computer and removes the M attribute. The data in this 
field is not sent to the computer again until it has been modified again in some 
way and the field once again flagged with the logical attribute M. 

• The ATTRIBUTE command may specify the logical attribute PM, for “protected 
modified.” A SEND MOD command sends the data in such a field to the computer, 
but does not remove the M attribute; thus a PM field is sent to the computer with 
every SEND MOD command. 


NOTE 

Logical attributes have effect only when the 4027 is in form fillout mode. 
When not in form fillout mode, the 4027 ignores logical attributes. 
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Visual Attributes 

On the 4027, the ATTRIBUTE command is used to give various visual attributes to the 
characters and their backgrounds. Characters and backgrounds may be assigned any of 
the eight color numbers (C0-C7), they may be inverted, or they may be made to blink 
between two visual attributes. 


Color Attributes 


On the 4027, visual attributes are used to select the color of the characters and the color 
of the background as listed below. 


lATT CO 
lATT C1 
lATT C2 
lATT C3 
lATT C4 
lATT C5 
lATT C6 
lATT C7 


is color 0 (default white) on color 7. (default black) 

is color 1 (default red) on color 7. 

is color 2 (default green) on color 7. 

is color 3 (default blue) on color 7. 

is color 4 (default yellow) on color 7. 

is color 5 (default cyan) on color 7. 

is color 6 (default magenta) on color 7. 

is color 7 (default black) on color 7. (Invisible) 


Inverted Attributes 


Characters and backgrounds may be inverted by using “I” and a color number as listed 
below. Default colors for the color numbers are the same as listed under the color 
attribute descriptions. 


lATT ICO 
lATTIC1 
lATT IC2 
lATT IC3 
lATT IC4 
lATT ICS 
lATT IC6 
lATT IC7 


is color 7 on color 0. 
is color 7 on color 1. 
is color 7 on color 2. 
is color 7 on color 3. 
is color 7 on color 4. 
is color 7 on color 5. 
is color 7 on color 6. 
is color 7 on color 7. (Invisible) 


The actual color displayed by each of the eight color names may be controlled by the 
color commands: MAP, RMAP, and MIX. 
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Blinking Attributes 

The 4027 can blink between two colors or between inverted and non-inverted by putting a 
hyphen (-) between the desired parameters. For example, the command 

lATT C2-C4 

causes the characters to blink between color numbers C2 and C4 on a C7 background. 
Blinking will not occur within a graphic area. 


4025-Style Visual Attributes 

4025-style attributes may be used to run a program on the 4027 which was written for the 
4025. The 4025 uses visual attibutes designated S, E, U, and I, and these parameter 
forms may be used on the 4027. The 4025 visual attributes correspond to 4027 color 
attributes as listed below: 


(Standard) = CO 

IE 

(Inverted, Enhanced) 

= IC2 

(Inverted) = ICO 

lU 

(Inverted, Underscore) 

= IC4 

(Enhanced) = C2 

EU 

(Enhanced, Underscore) 

= C6 

(Underscore) = C4 

lEU 

(Inverted, Enhanced, 




Underscore) 

= IC6 


NOTE 

Like font attributes, visual attributes affect the display even when the 4027 
is not in form fillout mode. 

Field Attribute Codes Within a Line 

Unless instructed otherwise by an ATTRIBUTE command, the 4027 begins each line with 
the default attribute in each class: font 0, alphanumeric logical attribute, and CO visual 
attribute. 

An attribute code may specify attributes from one, two or all three classes of field 
attributes. As the 4027 scans each line in its display list, it searches for attribute codes. 
When it encounters a new attribute code, it modifies only the class or classes of attributes 
specified in this new code; the other class or classes of attributes are not modified. 
Suppose, for example, the following line is stored in the display list: 

<font 0,protected,C2>-<numeric>-<CR> 

Since the second attribute code specifies only the logical attribute numeric, the second 
field is displayed in font 0, C2 (the font and visual attributes of the preceding field). 
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CREATING FIELDS 

Each field in a line is created by specifying the font, logical, and visual attributes which 
the fieid possesses. The ATTRIBUTE command is used for this purpose. 


ATTRIBUTE Command 

Syntax 

lATTribute [<font>] [<logical>] [<visual>[-<visual>]]<CR> 

where <font> denotes a font attribute, <logical > denotes a logical attribute, and each 
< visual > denotes one or more visual attributes. 


Action 

The ATTRIBUTE command inserts a field attribute code into the workspace display list at 
the cursor position. This field attribute code marks the beginning of a new field and 
designates the font, logical, and visual attributes of this field, as specified in the 
ATTRIBUTE command. If this field is the first field in the line, the ATTRIBUTE command 
specifies the attributes of the field which differ from the default attributes. If the field is 
preceded by another field on the same line, the ATTRIBUTE command specifies the 
attributes of the new field which differ from those of the preceding field. If two visual 
attributes or sets of attributes are separated by a hyphen, the display blinks that field 
between the two specified visual attributes or sets of visual attributes. The display will not 
blink between visual attributes within a graphic area. 


Restrictions on Syntax 

For the 4027, <font> is an integer between 0 and 31, inclusive. <font> defaults to 0 (at 
the beginning of a line) or to the font attribute of the preceding field. 

For the 4027, 

<logical> = [ A | N | P | PM ] 

where A denotes alphanumeric, N denotes numeric, P denotes protected, and PM denotes 
protected modified. These parameters must be given in this single letter form. 

<Logical > defaults to A (at the beginning of a line) or to the logical attribute of the 
preceding field. 
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For the 4027, 

<visual> = [<color name> | l<color name>] 
and 

-<visual> =-[<color name> | l<color name>] 

where <color name> Is a color number C0-C7 and I denotes inverted. The order of the 
color names does not affect the display. Also, the 4025-style attributes (S, E, I, and U) 
may be used in place of <color name>. 

If the -<visual> parameter is specified, the display blinks between the two attributes or 
sets of attributes specified. For example, visual attributes of C2-C4 cause the field to 
blink between 02 and 04 visual attributes. 

For the 4027, <visual> defaults to 00 (at the beginning of a line) or to the visual 
attribute(s) of the preceding field. 

When using 4025-styie attributes (S, E, U, I), no spaces are allowed between alphabetic 
parameters in the ATTRIBUTE command. To define a protected field with the enhanced 
and inverted visual attributes, for example, give the command 

!ATTPEI<OR> 

To blink that field between the enhanced and inverted visual attributes, give the command 
lATT PE-l<OR> 


Examples of ATTRIBUTE Commands 
Font Attributes 


lATT 0 <OR> Defines a new field beginning at the cursor position. When 
!ATT<0R> characters are entered in this field, the field displays characters 

from Font 0, the standard font. 


lATT 1 <OR> Defines a new field beginning at the cursor position. When 
characters are entered in this field, the field displays the 
corresponding character from Font 1, the Ruling Characters font. 
(Requires Option 32.) 
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!ATT 1 C4<CR> 

!ATT 30<CR> 

Logical Attributes 

!ATT A<CR> 

!ATTN<CR> 

!ATTP<CR> 

!ATT PM<CR> 

Visual Attributes 

!ATT CO<CR> 

!ATTC2<CR> 

!ATT ICO<CR> 


Defines a new field beginning at the workspace cursor position. 
When characters are displayed in this field, it displays the 
corresponding characters in color C4 from character Font 1 
(ruling characters). (Requires Option 32.) 

Defines a new field beginning at the workspace cursor position. 
When characters are entered in this field, the field displays 
characters from Font 30. The characteristics of Font 30 must 
first have been set by the FONT command which is described in 
the Graphics section. Fonts 1 through 31 are user definable, but 
Font 31 is reserved for patterns and, if used, results in an error 
condition. 


Defines an alphanumeric unprotected field beginning at the 
cursor position. 

Defines a numeric unprotected field beginning at the cursor 
position. In form fillout mode, only characters with ADEs 32-63 
can appear in this field. 

Defines a protected field, beginning at the cursor position. In 
form fillout mode, this field cannot be typed into or erased. 

Defines a protected modified field beginning at the cursor 
position. This field is transmitted to the computer with any 
subsequent SEND MOD command. 


Defines a new field beginning at the cursor position. Displays 
that field with the standard visual attribute of color CO on color 
C7. 

Defines a new field beginning at the cursor position. Displays 
that field with the enhanced visual attribute of color C2 on color 
C7. 

Defines a new field beginning at the cursor position. Displays 
that field with the inverted visual attribute of color C7 on color 
CO. 
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!ATT C4<CR> Defines a new field beginning at the cursor position. Displays 
that field with the underscored visual attribute of color C4 on 
color C7. 

lATT C2-C0<CR> Defines a new field beginning at the cursor position and blinks 
that field between the visual attributes C2 and C4. This provides 
blinking between color CO and color C2 on color C7. 

lATT IC2-C4<CR> Defines a new field beginning at the cursor position and blinks 
that field between the visual attributes of inverted C2 with C4. 
This provides characters blinking between C4 and C7 with 
background blinking between CO and C2. 

lATT C3-IC4<CR> Displays the field beginning at the cursor position with the 

inverted attribute and alternate blinking between the specific 
colors. The dash before the inverted attribute creates the 
blinking attribute. The attribute will appear as colors C3 and C7 
on a background of colors C4 and C7. 

lATT PMS-C6<CR> Sets up a protected field, labels it “modified” for SEND MOD 

operations, and causes it to be displayed as a blinking between 
colors CO and C6. 


Creating Fields with JUMP 

The JUMP command can be used with the ATTRIBUTE command to create several fields 
on one line. Suppose you want to create a protected C2 field 60 character positions in 
iength in row 3 of the workspace. The command 

lJUM 3IATT PC2;-(60 spaces)-<CR> 

creates the desired field. However, the command 

lJUM 3IATT PC2IJUM 3,60IATT PC0<CR> 


creates the desired field more quickly and with more efficient coding. 
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The JUMP command can be used to create several fields on one line of the workspace. 
Suppose you want row 5 to appear as follows: 


Field 1 



1 20 50 60 

PROTECTED PROTECTED NUMERIC 

Color cO Color c2 Color c4 


(2402) 2657-25 


This can be done by transmitting the fields as series of spaces, as in our first example. 

But the command sequence 

!JUM 5IATT PC0;Field 1 !JUM 5,20!ATT PC2IJUM 5,50!ATT NC4;Field 3-<CR> 

gives the same display and transmits fewer characters than sending the first two fields as 
series of spaces. 

Suppose the workspace cursor is in the home position (row 1, column 1) and consider the 
three command sequences: 

1. !ATT P;Name !ATT AC2IJUM 1,25!ATT PC0<CR> 

2. !ATTP:Name !ATTAC2!JUM 1,25!ATT COIJUM 1,60!ATT PC0<CR> 

3. !ATT P:Name !ATT AC2IJUM 1,25!ATT PCOUUM 1,80!ATT PC0<CR> 

When executed, each of these command sequences causes the same display: 


Name 



2402-23 


Each sequence, however, creates a very different “line” in the 4027 display list, and the 
differences between them are important when the 4027 is in form fillout mode. 

The line generated by sequence 1. ends in column 25; the display list contains nothing 
beyond that column. If the operator moves the cursor right of column 25 in line 1 and 
presses a key, the cursor moves to the beginning of the next unprotected field and prints 
the typed character there. The terminal bell does not ring. 
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The line generated by 2. ends in column 60. Columns 26 through 60 constitute an 
unprotected field. If the operator types in these columns, the text is printed just as it is 
typed. 

The line generated by 3. ends in column 80; all 80 columns of the screen are included in 
this line. Columns 26 through 80 constitute a protected field. If the operator moves the 
cursor into this field and types a character, the terminal bell rings, the cursor moves to the 
beginning of the next unprotected field in the form, and the character is printed there. 



When using the JUMP command to create fields, always "tie down" the 
line with the !ATTPCO command, as shown in the preceding examples. If 
this is not done, the display list may not include the last field created with 
JUMP. 
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RULINGS 

You can highlight the structure of a form by drawing rulings, or ruling lines. The 4027 with 
the Ruling Characters font (Option 32) has two provisions for doing this. First, the basic 
command set includes the HRULE (Horizontal Rule) and VRULE (Vertical Rule) 
commands. Second, the Ruling Characters font (Option 32) itself provides additional 
ruling characters for making junctions between horizontal and vertical rulings. 

Horizontal and vertical rulings can be made any of the 64 colors by assigning a visual 
attribute to each line or location at which the ruling appears. When making horizontal 
rulings, assigning a visual attribute works well since the attribute can be made to color 
the entire row in the display. When visual attributes are given to vertical rulings, however, 
they must be given for each row in which the vertical ruling appears. 


HRULE (Horizontal Rule) Command (Requires Option 32) 

Syntax 

IHRUIe <row> <column> [<length> [<width>] ]<CR> 

where all parameters are positive integers. The <row> and <column> parameters give 
absolute workspace coordinates (as in the JUMP command). Since there are only 80 
columns, the <column> parameter must not exceed 80 and the sum of <column> and 
< length > must not exceed 81. The < width > parameter, if specified, must be either 1 or 
2. The default value for both < length > and <width> isl. 

Action 

This command draws a horizontal ruling in the workspace. The first character of the ruling 
is inserted at the row and column specified by the <row> and <column> parameters. 
The ruling continues to the right for a total of <length> columns. This ruling is a single 
line if <width> is 1 and a double line if <width > is 2. 


Examples 

!HRU3,5,20<CR> 
!HRU 3,5,20,1 <CR> 

!HRU3,5,20,2<CR> 


Beginning at row 3, column 5 of the work¬ 
space, draws a horizontal ruling through 20 
columns (columns 5 through 24). The ruling 
is a single line. 

Beginning at row 3, column 5 of the 
workspace, draws a horizontal ruling through 
20 columns (columns 5 through 24). The 
ruling is a double line. 
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VRULE (Vertical Rule) Command (Requires Option 32) 


Syntax 

IVRUIe <row> <column> [<length> [<width>] ]<CR> 

where all parameters are positive integers. The <row> and <column> parameters are 
absolute workspace coordinates (as in the JUMP command). The <column> parameter 
may not exceed 80. The <width > parameter, if specified, must be either 1 or 2. The 
default value of both < length > and < width > is 1. 


Action 

This command draws a vertical ruling in the workspace. The first ruling character is 
inserted at the row and column specified by the <row> and <column> parameters. The 
ruling continues downward for a total of <length > rows. If <width> is 1 (or omitted), the 
ruling is a single line; if <width> is 2, the ruling is a double line. 


Examples 

!VRU 3,5,20<CR> 
!VRU 3,5,20,1 <CR> 


!VRU 3,5,20,2<CR> 


Beginning at row 3, column 5 of the work¬ 
space, draws a vertical ruling through 20 
rows (rows 3 through 22). This ruling is a 
single line. 

Beginning at row 3, column 5 of the work¬ 
space, draws a vertical ruling through 20 
rows (rows 3 through 22). This ruling is a 
double line. 


NOTE 

If the 4027 receives an HRULE or VRULE command but does not contain 
Option 32, each character cell affected by the command is displayed as a 
rectangle with all its matrix dots turned off (black). 
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Making Correct Junctions 

While the HRULE and VRULE command are convenient, vertical and horizontal rulings 
drawn with these commands do not cross or join each other. Each ruling character 
occupies an entire character cell on the display, and a character cell which contains a 
vertical ruling character cannot contain a horizontal ruling character. For example, 
suppose you give the following sequence of commands; 

IVRU 3,20,10,1 <CR> 

IVRU 3,30,10,1 <CR> 

IVRU 3,40,10,1 <CR> 

IVRU 3,50,10,1 <CR> 

IVRU 3,60,10,1 <CR> 

IHRU 3,20,41,1 <CR> 

IHRU 5,20,41,2<CR> 

IHRU 12,20,41,1 <CR> 

At this point, the basic structure of the form has been created, but the junctions between 
horizontal and vertical rulings need to be added. The workspace display appears as 
follows: 


1 1 1 

1 






The variety of ruling characters provided in the Ruling Characters Font (Option 32) allows 
the programmer or operator to make neat, well-fitted junctions by selecting appropriate 
font characters. The Ruling Junctions Chart (Figure 9-3) is a reference sheet for making 
junctions on the 4027. With it you can make junctions for this sample form with the 
sequence of commands: 

!JUM3,20;@!JUM3,30:A!JUM3,40;A!JUM3,50;A!JUM3,60;B<CR> 

IJUM5,20; \ !JUM5,30;K!JUM5,40:K!JUM5,50:K!JUM5,60: <CR> 

IJUM12,20:P!JUM12,30;Q!JUM12,40:Q!JUM12,50;Q!JUM12,60:R<CR> 
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Now the form looks like this: 



A complete table of ruling characters is given in Appendix D. 


4024/4025 Rulings 


(Font 1) 


Standard 
(Font 0) 
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TYPING IN FORM FILLOUT 


THE EFFECT OF FORM FILLOUT ON 4027 COMMANDS 

Form fillout mode alters the action of some of the 4027 commands, but does not affect the 
action of others. For commands discussed in later sections, any effects of form fillout 
mode on a command are discussed when the command is introduced. Some of the display 
control commands already discussed are affected by form fillout mode: 

• The TAB, BACKTAB, and ERASE commands (and their corresponding keys) are 
affected by form fillout mode. 

• The UP, DOWN, RIGHT, LEFT, RUP, and RDOWN commands (and their corre¬ 
sponding keys) are not affected by form fillout mode. The JUMP command is not 
affected by form fillout mode, but is still useful for working with forms. 

The following discussion assumes that the 4027 is in form fillout mode, that commands 
come from the computer, and that text from the computer is directed into the workspace. 

Typing in Form Fillout 

When the 4027 is in form fillout mode, text can be entered only in the unprotected fields 
of the form. If the operator types a character while the 4027 is in form fillout mode, text 
can be entered only in the unprotected fields of the form. If the operator types a character 
while the workspace cursor is in a protected field, the terminal bell rings and the typed 
character is inserted in the first column of the next unprotected field in the form. 

If the cursor is in the last column of an unprotected field and the operator types a 
character, the character is inserted in that column and the cursor moves to the first 
column of the next unprotected field of the form. 

If the cursor is moved beyond the last field in a line (using JUMP or a cursor key) and a 
character is typed, the cursor moves to the beginning of the next unprotected field in the 
form and the typed character is entered there. In this case, the terminal bell does not ring. 
(See the Creating Fields with JUMP discussion earlier in this section.) 

When a form is created, a line of the form may consist only of a carriage return, <CR>. 
Such a line contains no protected or unprotected fields; it appears on the terminal screen 
as a blank line, but in the workspace display list only a <CR> is stored. If the cursor is 
positioned anywhere in such a line and a character is typed, the cursor moves to the 
beginning of the next unprotected field in the form; the terminal bell does not ring. 

If the cursor is moved beyond the last unprotected field in the form and a key is pressed, 
the cursor moves to column 1 of the last line in the workspace window. The typed 
character is not displayed. 
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TAB in Form Fillout 

Each tab character advances the workspace cursor to the beginning of the next 
unprotected fieid in the form, if the cursor is in the iast unprotected fieid of the form, the 
next tab character sends the cursor to the home position at the beginning of the first 
unprotected fieid. 


Examples 

Suppose the sample form shown below is displayed in the workspace, with the cursor 
positioned as shown. 


Name JcW» Bue-.' Age 22 yrs. 

CURSOR -■ 

Height S .Tt. Weight 220 lbs. 

Social Security Number -000- 0&- 0000 

2402-24 


1. The command 
!TAB<CR> 

moves the cursor to the beginning of the next unprotected field. 
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2. The subsequent command 
!TAB4<CR> 


advances the cursor four unprotected fields and positions it as shown. 


Name John Dew Age 22 yrs. 

Height 6 -ft. 4 in. Weight lbs. 

Social Security Number ■ '0i0- 

■. . ... 


CURSOR AFTER 
1TAB4<CR> 

2402-26 


3. The subsequent command 


!TAB3<CR> 


advances the cursor through the last two unprotected fields of the form and 
back to the home position. 


CURSOR IN HOME 

Natiw Doe Age Zi yrs. 


POSITION AFTER — 


!TAB 3<CR> 

Height 6 ft. 4 in. Weight lbs. 

Social Security Number 000h 00^ 0000 

2402-27 
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BACKTAB in Form Fillout 

A BACKTAB character moves the cursor to the beginning of the unprotected fieid in 
which it is located. If the cursor is already at the start of an unprotected field, or if it is not 
inside an unprotected field, a BACKTAB character moves the cursor to the start of the 
preceding unprotected field. If the cursor is already at the start of the first unprotected 
field in the form, a BACKTAB character leaves the cursor where it is. 


Examples 

Suppose the cursor is positioned in the last unprotected field of our sample form, as 
shown. 



1. The command 
!BAC<CR> 

moves the cursor to the beginning of the unprotected field in which it is located. 


Name fge yrs. 

Height .'ilv'ft. Weight 

Social Security Number ^uncon 

2402-29 
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2. Any of the subsequent commands 

!BAC 7<CR> 

!BAC8<CR> 

!BAC9<CR> 


moves the cursor through all the preceding seven fields of the form, to the 
beginning of the first unprotected field. 
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ERASE in Form Fillout 

In form fillout mode, the ERASE command erases only the contents of the unprotected 
fields in the form and leaves the cursor at the beginning of the first unprotected field. 

Example 

Suppose a sample form is filled out as shown and the information in the form is sent to the 
computer. 


Name John Doe Age 22 yrs. 

Height ! §; -ft. 4 in. Weight 920^^ Ihs. 

Social Security Number ,000- ^0- 0000 

2402-31 


The command 
lERA W<CR> 

erases the contents of the form and leaves the cursor positioned as shown. 



Name Age 



CURSOR - 

__ ■ 




Height ft. in. Weight 

lbs. 



Social Security Number 






2402-32 


The command 
!ERA<CR> 

also does this if, as we assume here, the device issuing the command 
(computer or keyboard) also types into the workspace. 
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The HOME Key and JUMP in Form Fillout 

When the 4027 is not in form filiout mode, the command 
!JUM<CR> 

has the same effect as pressing the HOME key. In each case, the workspace cursor 
moves to row 1, column 1, the “home” position. 

In form fillout mode, pressing the HOME key moves the cursor to the beginning of the first 
unprotected field in the form, which generally does not begin in row 1, column 1. But the 
JUMP command has no respect for form fillout mode. Giving the command 

!JUM<CR> or 
lJUM 1,1<CR> 

moves the cursor to row 1, column 1, whether or not that field is protected, unprotected, or 
even part of the form. 

The JUMP command can still be used, with the TAB command, to simulate the action of 
the HOME key. As long as row 1, column 1 is a protected location, the sequence of 
commands 

!JUM!TAB<CR> 

moves the cursor first to row 1, column 1 (iJUM), then to the beginning of the first 
unprotected field in the form (ITAB). 
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TRANSMITTING FORMS AND FORM DATA 

Because of the formatted nature of forms and form data, special care must be taken when 
transmitting either to the computer. The SEND command and the FIELD command have 
been specially designed for transmitting form information. 


SEND in Form Fillout 


Syntax 

iSENd [ All I Mod]<CR> 

The default parameter is All; that is, !SEN<CR> is equivalent to iSEN A<CR>. 

There are two uses of the SEND command involving forms. 

First, suppose the operator has constructed a form in the workspace and wishes to store 
this form in the computer. (The 4027 with Option 4 can also store forms or form data on a 
Tektronix 4924 Digital Cartridge Tape Drive. See the Peripherals section.) After making 
sure that the 4027 is not in form fillout mode, the operator gives the SEND command. (If 
the 4027 is not in form fillout mode, the SEND, SEND ALL, and SEND MOD commands are 
equivalent.) This command sends all the information in the workspace to the computer. 
Field attribute codes in the workspace display list are automatically encoded as 
ATTRIBUTE commands; thus, when the form is sent back to the 4027 from the computer, 
the 4027 has the information necessary to reconstruct the form. 

Second, suppose a form is displayed, the terminal is placed in form fillout mode, and the 
form is filled out. The operator now wishes to send the data in the form (not the form itself) 
to the computer for storage or processing. With the 4027 in form fillout mode, the operator 
uses either the SEND ALL command or the SEND MOD command. 

The SEND ALL command sends to the computer the data in each unprotected field of the 
form. 

The SEND MOD command sends to the computer the data in just those fields flagged with 
the logical attribute M (modified). In this case, the data in a field is sent to the computer if 
and only if (1) the field is an unprotected field whose contents have been changed since 
the last SEND or SEND MOD command, or (2) the field is a protected field permanently 
flagged with the logical attribute PM (protected modified). 
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When a SEND MOD command is given, then, consecutive blocks of data may not come 
from consecutive unprotected fields in the form. For the applications program to process 
the data correctly, however, it must know the form location from which each block of data 
comes. Therefore, when a SEND MOD command is executed, the data from each modified 
field is sent to the computer, preceded by a pair of three-digit numbers separated by a 
comma. These numbers specify, in absolute workspace coordinates, the row (first 
number) and column (second number) of the first character position of the field. Suppose, 
for example, a modified field begins in row 5, column 3. When the data in this field is sent 
to the computer, it is preceded by the string 005,003. Examples of transmissions using 
the SEND MOD command appear later in this section. 
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FIELD in Form Fillout 

Syntax 

IFIEId [<separator>]<CR> 

where <separator> is a single printing ASCII character or a two- or three-digit ADE of an 
ASCil character. If no <separator> is specified, it is assumed to be NUL, whose ADE is 
00 . 


Action 

The FIELD command sets the field separator. If any non-NUL field separator is specified, 
that character precedes the data sent to the computer from each field; trailing spaces are 
not transmitted. 

If no field separator (or the NUL separator) is specified, aii the data in each field is 
transmitted to the computer by a SEND (ALL or MOD) command. If a field is not 
compietely filled out, all the spaces at the end of the field are treated as data and sent to 
the computer, along with the rest of the data in the field. 

The 4027 remembers its field separator when powered off or RESET. 


Examples 

IFIE @<CR> 
IFIE 64<CR> 

IFIE 9<CR> 

IFIE 09<CR> 

IFIE<CR> 


Sets the field separator to the @ character, 
whose ADE is 64. 

Sets the field separator to the ASCII charac¬ 
ter 9. 

Sets the field separator to the ASCII HT 
(horizontal tab) character, whose ADE is 09. 

Sets the field separator to NUL. When data 
in a field is sent to the computer, no field 
separator is used. 


@ 


4027 PROGRAMMER’S 


9-29 



FORMS AND FORM FILLOUT 

SAMPLE TRANSMISSIONS 


Some Sample Transmissions 

Suppose the following form begins in row 1 of the workspace. The unprotected fields are 
attribute C2 (shown here shaded gray); the last unprotected field has logical attribute 
numeric. The end of each non-blank line is at the end of the iast unprotected field in the 
line. The three lines containing unprotected fields are separated from each other by blank 
lines. 


Name 





Address 





City 

State 


ZIP 

2402-33 


To store this form in the computer, give the command 
!SEN<CR> 

The following information is sent to the computer: 

lATT P;---Name lATT AC2;-<CR>!ATT 

P<CR> 

! ATT P; - Address IATTAC2:-<CR>!ATT 

P<CR> 

!ATT P:-City lATT AC2:-lATT PCO:-State:IATT AC2:- 

-lATT PCO:-ZIP lATT NC2:-<CR> 


Transmitted spaces are shown here as dashes. Remember that the default logical 
attribute of lines 2 and 4 (the blank lines) is alphanumeric. These lines must be protected 
to prevent text from being entered in them. 

Suppose now the 4027 is placed in form fillout mode and the form is filled out. 
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Name 

Address 

Jotm Due. - 

IIH M; Ftm St. 



City 

. State &r.fgk« ZIP 00 


2402-34 


1. If no field separator is specified, the command 
iSEN A<CR> 

sends the following data to the computer: 

John Doe-<CR>1111 —W.—First—St.- 

<CR>Anytown-Oregon-00000<CR> 


No field separator is used and each field is sent, including all trailing spaces. In 
a programming language which can divide an incoming line into blocks of 
predetermined length (such as COBOL), this is a convenient format. 

2. Suppose the field separator is the number sign, (#). The command 

ISEN A<CR> 

now sends the following to the computer 

#John—Doe<CR> 111 —W.—First—St.<CR> #Anytown?f^Oregon 

?f«00000<CR> 

The host program must use the # character to distinguish data from different 
fields. 

3. Suppose that the same form is filled out for John Doe’s sister, Jane Doe, who 
lives at a different street address in Anytown. Instead of erasing the form, the 
operator presses the HOME key to return the cursor to the first unprotected 
field, and simply types over the old information which must be changed. 
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Natne Jane Doe 
Address 9999 W. Ninth St. 

City Anytown State Oreyon ZIP 00000 

2402-35 


Now the first two unprotected fields are flagged with the logical attribute M. The 
SEND MOD command sends the data in these fields to the computer. 

If no field separator is specified, the command 

ISEN M<CR> 

sends the following data to the computer: 

001,01 OJane—Doe- 

< CR > 003,0109999W.- Ninth -St. < CR > 

Note that no spaces or other characters separate the row and column 
identifiers from the first character in the field. 

4. Finally suppose the form is filled out for John’s brother. Brad Doe, with no street 
address information provided, and the City and ZIP information modified: 


Name Brad Dc>e 
Address 

City Someto«n State Oregon ZIP 99999 

2402-36 


If the field separator is the # character, the command 
ISEN M<CR> 

sends the following data to the computer: 

#001,01 OBrad - Doe <CR> #003,010<CR> #005,01 OSometown #005,010 
99999 <CR> 


9-32 


4027 PROGRAMMER’S 





Section 10 


TEXT EDITING 


THE TEXT-EDITING COMMANDS 

The 4027 recognizes four commands designed specifically for text editing: DCHAR 
(Delete Character), ICHAR (Insert Character), DLINE (Delete Line), and ILINE (Insert Line). 


NOTE 

If an editing command is typed on the keyboard and text from the keyboard 
is printed in the monitor, execution of the command inserts a blank line 
just below the line on which the command is typed. All examples deal with 
the workspace display. 


DCHAR (Delete Character) Command 

Syntax 

IDCHar [<count>]<CR> 

where <count< is a positive integer. If <count> is not specified, it defaults to one. 


Action 

This command deletes <count> characters, beginning with the character at the cursor 
position. As each character is deleted, characters to the right of the cursor shift left to fill 
the gap. The cursor does not move. If the terminal is in form fillout mode, only characters 
to the right of the cursor in the same field shift left. If the terminal is not in form fillout 
mode, all characters right of the cursor on the same line shift left. 

This command is equivalent to pressing the DELETE CHARACTER key <count> times. 
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DCHAR COMMAND 

Examples 

Suppose the following text is displayed in the workspace, with the cursor position as 
indicated; 

Everything seems^eems in order. 

The command 
!DCH<CR> 

or 

IDCH1 <CR> 

deletes the s at the cursor position, leaving the following display: 

Everything seems gems in order. 

The subsequent command 
!DCH5<CR> 
leaves the desired display: 

Everything seemsgn order. 

Suppose a form contains incorrect information in an unprotected field; with the cursor 
positioned as shown: 

Name; Jane Do^DoeAge: 23 

The command: 

!DCH4<CR> 

deletes the middle “Doe” and the extra space. Neighboring fields are not affected: 
Name: Jane Doe^ Age: 23 
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ICHAR (insert Character) Command 

Syntax 

!ICHar<CR> 


Action 

The ICHAR command places the 4027 in insert mode. This command is equivalent to 
pressing the INSERT MODE key. 

In Insert mode, when new text is sent from the computer or typed on the keyboard, the 
cursor, the character at the cursor position, and characters to the right of the cursor are 
shifted right to make room for the new text. 

Suppose the text 

ENDgAGE 

is displayed In the workspace, with the cursor positioned as shown. If the string 
!ICH;OF <CR> 

is sent from the computer, it inserts the text OF (including a space) and displays the text 
|ND OF PAGE 

in the workspace, with the cursor positioned to the left of the line. 

If the string 

!ICH:OF <CR> 

is typed from the keyboard, the <CR> is sent to the workspace as text, and the cursor is 
positioned at the beginning of the next line: 

END OF PAGE 
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In form fillout mode, only characters in the unprotected field containing the cursor are 
shifted right. Characters shifted past the rightmost position in that field are lost. 

The DCHAR key can be used to delete unwanted characters at or to the right of the cursor 
position, WITHOUT leaving insert mode. 

Any other cursor movement, resulting either from giving a command or from pressing a 
key, will cause the 4027 to leave insert mode. 


Examples 

Suppose the terminal is in form fillout mode and the following form is displayed, with the 
cursor positioned as shown. The only unprotected fields are the three inverted fields; all 
other fields are protected. 

NAME: Ebeneze^crooae Age: 77_ 

Position Applied for: Miser 

If the string 

IICH; A 

is sent from the computer the following display results 

NAME: Ebenezer AScrooge Aae: 77 
Position Applied for: Miser 

The subsequent string 

IICH;ber 

sent from the computer results in the form fillout display 

Name: Ebenezer Aber Scro Aae: 77 
Position Applied for: ^iser 
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Finally, the string: 

!ICH;nathy 

sent from the computer, moves the cursor past the end of the first unprotected field and 
into the second unprotected field. The following first lines of the form will be seen in rapid 


succession: 



Name: 

Ebenezer Abern ScrAae: 

77 

Name: 

Ebenezer Aberna ScAae: 

77 

Name: 

Ebenezer AbernaTSAae: 

77 

Name: 

Ebenezer Abernafl Aae: 

77 

Name: 

Ebenezer AbernathvAae: 

77 


If the second unprotected field has the A (alphanumeric) attribute, any further insertion of 
characters shifts characters in the second field to the right and the old characters are 
lost. If the string 

!ICH:B 

is sent from the computer, the following display results: 

Name: Ebenezer Abernathv Age: B7 
Position Applied for: Miser 

However, if the second unprotected fieid has the N (numeric) attribute, a subsequent 
ICHAR command which inserts alphabetic characters moves the cursor to the first 
position of the numeric field, rings the bell, and does not insert succeeding characters. 

If the insert character operation moves the cursor past the last unprotected field on the 
form, the cursor moves to the beginning of the first unprotected field which can accept the 
new characters: the new characters are inserted in that fieid. 
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DLiNE (Delete Line) Command 

Syntax 

IDLIne [<count>]<CR> 

where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 

If the 4027 is not in form fillout mode, this command deletes <count> consecutive lines 
of text, including the line containing the cursor. If the cursor is in the middle of a line, the 
entire line is deleted. As each line is deleted, the lines below roll up to fill the gap. 

In form fillout mode, this command erases the contents of all unprotected fields in 
<count> lines of the form. The line containing the cursor is counted as a deleted line, 
whether or not it contains any unprotected fields. After this line, only lines containing at 
least one unprotected field are counted as deleted lines. The cursor is positioned at the 
beginning of the next unprotected field, after the last field is erased. 

This command is equivalent to pressing the DELETE LINE key <count> times. 


Examples 


Suppose the terminal is not in form fillout mode, and 
the workspace contains the text shown, with the 
cursor in line 2, column 8: 


The command 


RSOR IN LINE 2, 
COLUMN 8 



!DLI 3<CR> 


gives the workspace display shown here: 


This is Line 1 
T hjs is Line 5 
This is Line 6 




- CURSOR POSITION 
AFTER !DLI 3<CR> 
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Suppose the terminal is in form fillout mode, and the workspace holds the form shown 
here. The unprotected fields are enhanced (shown here shaded gray): 


Name Doe ■ 

Date June 1, 

Position Applied For Office Manager 
References 


Bil! Brom 
Caral Cr«ie^- 
Dan De«f) 


2402-37 


If the cursor is positioned anywhere in the first line of the form, the command 
!DLI<CR> 

resuits in the display shown below. 


CURSOR AFTER 
IDLI <CR> 


Name 

Date ^une I, 

Position ^plied For Office 
References 

Bill Brottn 

Dan Dean 


2402-38 
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The subsequent command 
!DLI 3<CR> 

results in the display shown here. Note that the line “References” is not counted as a 
deleted line, since it contains no unprotected fields. 



Name 

Date 

Position (^plied For 

References 



CURSOR AFTER 

Carol Oane 



!DU3<CR> 

Dan Dean 


2402-39 


Suppose you begin with the form shown below and the cursor positioned as shown: 



Name John Doe 



Date JuMfw 1, 1978 



Position Applied For Office Hanager 


CURSOR _ 

References 


POSITION 

Bill Broun 






Dan Dean 

2402-40 
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The command 
!DLI 3<CR> 

results in the display shown here. Observe that the line which originally contained the 
cursor has been counted as the first deleted line, even though it contains no unprotected 
fields; 


Name Doe 
Date June 1, 1978 

Position f^plied For Office Mane^r 
References 

LINES ERASED 

CURSOR AFTER Dan Dean 

!DLE3<CR> 

2402-41 
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■LINE (Insert Line) Command 

Syntax 

MLIne [<count>]<CR> 

where <count> is a positive integer. If <count> is not specified, it defaults to one. 

Action 

This command inserts <count> blank lines into the text immediately below the line 
containing the cursor. The cursor is positioned at the beginning of the newest line. Lines 
of text below the cursor position are rolled down to make room for the inserted blank 
lines, and the scroll is lengthened so that these lines are saved in the display list. 

This command is equivalent to pressing the INSERT LINE key <count> times. 

The ILINE command makes it easy to insert new text between lines of old text. Use the 
ILINE command to create several blank lines at the desired location. Type the new 
information into the blank lines; and use the DLINE command to delete any blank lines 
left over. 


NOTE 

For text editing appiications, the first iine entered into the workspace 
shouid always be blank. If new text must be inserted above the old text, the 
cursor is moved to the beginning of the workspace and the ILINE 
command is used to create space for the new text. If the first line of the 
workspace already contains text, this procedure inserts blank lines below 
the first line of old text, rather than above it. 


Examples 

Suppose the workspace contains the text shown 
opposite, with the cursor positioned as shown; 
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The command 
!IU3<CR> 

inserts three blank lines between line 2 and line 3, 
leaving the cursor in column 1 of the newest blank 
line: 


J<CR> 



When the 4027 is in form fillout mode, the ILINE command has no effect. 
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Section 11 


PERIPHERALS 


The 4027 supports the following peripherals: 

• With Option 3 (RS-232 Peripheral Interface), the 4027 supports a Tektronix 4642 
Printer and other compatible printers. 

• With Option 4 (GPIB Interface), the 4027 supports up to four Tektronix 4924 
Digital Cartridge Tape Drives and up to two Tektronix 4662 Interactive Digital 
Plotters. 

• With Option 42 (Hard Copy and Video Out), the 4027 supports the Tektronix 4632 
Video Hard Copy Unit. 


Throughout this section the term “devices” is used. This term always refers to one of the 
following: a peripheral device such as the printer or a tape unit, the host computer, the 
4027 monitor, or the 4027 workspace. These devices are specified by device mnemonics 
as follows: 


Device 


Mnemonic 


Printer 

Tape Units 1-4 
Plotters 1,2 
4027 Monitor 
4027 Workspace 
Host Computer 


Por PR 

TA1-TA4 (TA1 may be shortened to T) 
PL1, PL2 
M or MO 
Wor WO 
Hor HO 


INITIALIZING THE 4027 FOR PERIPHERAL 
COMMUNICATIONS 

Before the 4027 can copy file information from one device to another, it must be correctly 
informed about the status of the various peripheral devices attached to it. SET commands 
are used to initialize the 4027 for communicating with peripheral devices. The SET 
command should be given for those and only those peripheral devices present and 
powered up. 
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SET Command (Requires Option 3 or 4) 

Syntax 

iSET <device> <parameter> [<parameter>] <CR> 
where 

<device> is a one to three-letter device mnemonic, and <parameter> is a parameter 
setting for the indicated device. The form of each <parameter> depends on which 
peripheral device is specified. 



Do not attempt to set parameters for devices which are not attached to the 
4027 and powered up. Giving such a SET command may disabie ail 
communications to the 4027 and require the 4027 to be reset. 


Printer Parameters (Requires Option 3) 

The 4027 comes from the factory set for communicating with a Tektronix 4642 Printer. 
There are two parameters, however, which can be set to allow the 4027 to communicate 
with printers other than the 4642 Printer. 

• Some printers recognize the ASCII form feed character (<FF>) as a signal to 
begin a new page; other printers do not. On such printers a series of line feeds 
(<LF> s) must be sent to begin a new page. The 4027 can be set to send either 
the ASCII form feed (<FF>) character or the proper number of ASCII line feed 
(<LF>) characters to cause the printer to begin a new page. 

• The ‘‘carriage return, line feed” mechanical operation which the printer uses to 
begin a new line is relatively slow, compared to 4027 data transmission speeds. 
Thus the 4027 has ‘‘printer delay” parameter which can be set. After the 4027 
sends a <CR><LF> or <FF> to the printer, it waits a specified length of time 
before sending another character. This gives the printer time to complete its 
mechanical functions before having to cope with new text to be printed. 
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The command which SETs the 4027 for printer communications has the following form: 
!SET PR [FI L][<delay>]<CR> 


where: 

• F stands for “form feed,” and instructs the 4027 to use a <FF> character as a 
page separator. 

• L stands for “line feed,” and instructs the 4027 to replace any <FF> character to 
the printer by the number of <LF>s required to begin a new page. 

• <delay> gives the printer delay. If <delay> is a positive integer, after the 4027 
sends a <CR>, <LF>, or <FF> to the printer, it waits <delay> tenths of a 
second before sending the next character. If <delay> =0, the 4027 communi¬ 
cates with the printer using “flagged simplex protocol.” This means that after the 
4027 has sent a <CR>, <LF>, or <FF> to the printer, it waits for the RS-232 
DTR (Data Terminal Ready) signal to become true before sending the next 
character. 


Examples 

ISET PR F 3<CR> 


ISET PR L<CR> 


ISET PR 0<CR> 


Instructs the 4027 to use a form feed 
character (<FF>) as the page separator; 
when the printer receives a <FF>, it begins 
a new page. This command also sets the 
printer delay to 0.3 seconds; after sending a 
<CR>, <LF>, or <FF> to the printer, the 
4027 waits 0.3 seconds before sending 
another character. 

Instructs the 4027 that the printer does not 
treat a <FF> character as the page separa¬ 
tor. The 4027 replaces a <FF> with the 
number of <LF> s required to begin a new 
page. 

Instructs the 4027 to communicate with the 
printer using flagged simplex protocol. After 
sending a <CR>, <LF>, or <FF>, the 
4027 waits for a DTR (Data Terminal Ready) 
signal from the printer before sending an¬ 
other character. 
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Tape Unit Parameters (Requires Option 4) 

To prepare the 4027 to communicate with a 4924 Digital Cartridge Tape Drive (hereafter 
referred to as a “tape unit”), three parameters must be set. 

• Since the 4027 can have up to four tape units connected to it, each tape drive is 
numbered: tape unit 1, tape unit 2, tape unit 3, or tape unit 4. 

• The 4924 is a GPIB device; that is, the 4027 communicates with it using a GPIB 
(General Purpose Interface Bus). Each tape unit has two GPIB addresses: a 
command address and a data address. Since a tape unit’s command address is 
always numerically just one larger than its data address, only the data address 
must be set. The GPIB data address of a tape unit must be set to an even number 
between 2 and 28, inclusive. This address must be physically set by switches on 
the back of the tape unit itself. But the 4027 must also be SET to send messages 
to the proper GPIB address. (See the 4027 Operator’s Manual Peripheral Devices 
section for operating procedures.) 

• The tape unit can record information in one of two formats. One format is 
compatible with the Tektronix 4050 Series Graphic System internal tape drive. 
This is the format normally used to store file information for the 4027, and is 
called “4051-compatible format.” 

The other format is compatible with the Tektronix 4923 Digital Cartridge Tape 
Recorder. This format should be used only if you must exchange tape cartridges 
with a 4923. 

The command which initializes the 4027 for communicating with a tape unit has the 
following format: 

!SET <device><address>[4051 |4923]<CR> 
where: 

<device> is one of the following: (TA1 | TA21TA31TA4). This identifies the given 

device as tape unit 1, tape unit 2, etc. 

<address> is an even number from 2 to 28, inclusive. This specifies the GPIB 

address assigned to the tape unit in all GPIB communications. 

The default [4051 14923] setting is 4051; if this parameter is not specified, 4051 - 
compatible format is assumed. The TA1 parameter may be abbreviated to T, but TA2, TA3, 
and TA4 may not be abbreviated. 
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A separate SET command must be given for each tape unit powered up and attached to 
the 4027. 


Examples 

!SET TA1 8 4051 <CR> 
!SET T 8<CR> 


!SET TA2 10 4923<CR> 


Instructs the 4027 that tape unit 1 is present 
at GPIB address 8, and instructs the 4027 to 
write data on tape unit 1 in 4051 -compatible 
format. The GPIB address for a tape unit 
must be even. (Requires Option 4) 

Instructs the 4027 that tape unit 2 is present 
at GPIB address 10, and instructs the 4027 
to write data on this tape unit in 4923- 
compatible format. (Requires Option 4) 


Plotter Parameters (Requires Option 4) 

To prepare the 4027 to communicate with a 4662 Interactive Digital Plotter (hereafter 
referred to as the plotter), two parameters must be set. 

• Since the 4027 may have two plotters attached to it, each plotter present must be 
numbered: plotter 1 or plotter 2. 

• Since the plotter is a GPIB device, it must be assigned a GPIB address. This 
address must be set physically by switches on the plotter; in addition, the 4027 
must be instructed to send information to the proper GPIB address. The plotter 
GPIB address may be any integer from 1 to 30 inclusive. It must not, however, be a 
tape unit address plus one, since this would duplicate the tape unit’s command 
address. (See SETting the Tape Unit Parameters earlier in this section.) 

The command which initiaiizes the 4027 to communicate with a piotter has the following 
format: 

ISET <device><address><CR> 
where: 

<device> is PL1 (for plotter 1) or PL2 (for plotter 2). 

<address> is an integer from 1 to 30, inclusive; this integer specifies the GPIB 

address of the plotter. 


@ 


4027 PROGRAMMER’S 


11-5 




PERIPHERALS 

SET COMMAND 


If two plotters are present, a separate SET command for each plotter is required. 


NOTE 

If switch settings on the back of the plotter are changed while the plotter is 
powered on, these switches are not read by the plotter until power is 
cycled. If you change the plotter’s address switches, go through the entire 
GPIB power up procedure. (See 4027 Operator’s Manual, the Peripheral 
Devices section.) 


Example 

ISET PL1 15<CR> Instructs the 4027 that plotter 1 is present 

at GPIB address 15. This must agree with 
the address switch settings on the plotter. 
GPIB addresses are specified for those, and 
only those, devices present and powered up 
on the GPIB. (Requires Option 4) 
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PERIPHERALS Command 

The PERIPHERALS command allows you to examine the 4027 settings for communicating 
with peripheral devices. 

Syntax 

iPERipherals [<device>]<CR> 

where <device> specifies a non-GPIB device on which the 4027 peripheral settings are 
to be listed. If <device> is not specified, it defaults to M (monitor). 

Action 

This command causes the 4027 to generate a peripherals data list. For each device 
attached to the terminal and powered up, this list gives the <device> parameter 
(explained in the SET discussion), the GPIB address (this field is blank for the printer), 
and a data field listing the parameter settings for that device (explained in the SET 
command discussion). 

The last line in the peripherals data list gives the EOF (end-of-file) string. (Setting the 
end-of-file string with the EOF command is discussed in System Status and Initialization.) 

Example 

IPER M<CR> Outputs a peripherals data list to the 4027 monitor. 

!PER<CR> 

A sample peripherals data list is shown in Figure 11-1. 
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The REPORT Command and Peripherals 

The REPORT command has the following syntax; 

IREPort <device><CR> 

The Host Programming for the 4027 section discusses the REPORT command and the 
format of the ANSwer sent to the host for device 00 (System Status Block), and device 01 
(workspace cursor), device 02 (graphic beam information), and device 03 (crosshair 
information). The 4027 can also report the status of each peripheral device and whether 
or not the given peripheral is present (attached to the 4027 and powered up on the GPIB). 
This allows an applications program to investigate which peripherals are present at a 
given time and branch or modify instructions accordingly. 

The peripherals have the following <device> numbers assigned: 

<device> Peripheral(s) 

04-07 Tape Units 1-4, respectively 

12,13 Plotters 1,2, respectively 

14 Printer 

Tape Unit 

When the command: 

IREPort n<CR> 

is given, and n is chosen from 04-07 (representing tape units 1-4, respectively), the 
status of the designated tape unit is reported to the computer. This report has the 
following format: 

IANS n,<p1 >,<p2>,<p3>: 

where: 

<p1 > = 1 if the tape unit is present; 0, if not. 

<p2> is a two-digit decimal value indicating the last tape error code. (See Table 
11 - 1 .) 

<p3> (4 bytes) = 4051 or 4923, indicating the format In which information is to be 
written on the tape. 
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Table 11-1 
TAPE ERROR CODES 


Code 

Meaning 

01 

Domain error or invalid argument 

02 

File not found 

03 

Mag tape format error 

04 

Illegal access 

05 

File not open 

06 

Read error 

07 

No cartridge inserted 

08 

Over-read 

09 

Write-protected 

10 

Read-after-write error 

11 

End of medium 

12 

End of file 


PloUer 

When the command: 

!REP 12<CR> 

is given, the status of piotter 1 is reported to the computer. This report has the following 
format: 

IANS 12,<p1 >,<p2>; 
where: 

<p1 > = 1 if the piotter is present; 0, if not. 

<p2> (6 digits) is the value or each bit of plotter status word 0. 

The command: 

!REP 13<CR> 

causes a similar report for plotter 2 to be sent to the computer. 
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Printer 

When the command: 

!REP 14<CR> 

is given, the status of the printer is reported to the computer. This report has the foiiowing 
format: 

IANS 14,<p1 >,<p2>,<p3>: 
where: 

<p1 > = 1 if the printer is present; 0, if not. 

<p2> = L if the iine feed option is used, F if the form feed option is used. (See the 
Printer Parameters discussion in this section.) 

<p3>(3 digits) is the ASCII integer vaiue of the printer deiay. (See the Printer 
Parameters discussion in this section.) 
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COMMUNICATING WITH PERIPHERALS 

The remainder of this section discusses commands which enable the 4027 to 
communicate with peripheral devices. The ALLOCATE, DIRECTORY, and KILL commands 
are used to communicate with a tape unit; the PASS command is used to communicate 
with a plotter; and the COPY command Is used to copy files from one device to another. 


ALLOCATE Command (Requires Option 4 and a 4924 Tape Unit) 

Before information can be recorded on a tape in 4051 -compatible format, files must be 
created on the tape to hold the information. This is done by using the ALLOCATE 
command. 


Syntax 

lALLocate <device><begfile><number><size><CR> 
where: 

<device> is a device mnemonic (T[A1], TA2, TA3, or TA4) which specifies the tape 
unit used to record information. 

<beg file> is a non-negative integer which specifies the number of the first file to 
be created. 

<number> is a positive integer which specifies the number of files to be created. 

<slze> Is a positive integer which specifies the number of eight-bit bytes which 
each newly created file is to contain. Each tape cartridge can store approximately 
250K bytes of information. 


Action 

This command creates new files on a tape inserted in the tape unit specified by the 
< device > parameter. 
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<beg file>=0. If the tape has not previously been used to record information, <beg 
fiie> must be set to zero. This causes the tape to be properiy initiaiized before a file 
structure is recorded on it. If the tape has already been used to record information, setting 
<beg fiie> to 0 destroys aii information previously recorded on the tape, including the 
fiie structure marked on the tape; then the tape is reinitiaiized. in either of these cases, 
new fiies 1 through <number> are created. Each new fiie contains enough space to 
store <size> eight-bit bytes of information. 

<beg file> positive, if <beg fiie> is positive, this command creates <number> 
consecutive new fiies on the tape. The first new fiie created is fiie number <beg fiie> and 
each new fiie contains enough space to hold <size> eight-bit bytes of information. 


Examples 

INITIALIZING AN UNMARKED TAPE 

Initializes the unmarked tape in tape unit 1 
and creates two fiies (fiies 1 and 2) of 5000 
bytes each. (If the tape has already been 
marked, this command destroys ali oid infor¬ 
mation on the tape.) 


lALL TA1 0,2,5000 <CR> 
lALL T 0,2,5000<CR> 


ALLOCATING FILE SPACE ON A MARKED TAPE 


!ALL TA1 1,2,5000<CR> 
!ALL T 1,2,5000<CR> 


Creates two new files on tape unit 1, begin¬ 
ning with fiie 1. Each new file contains 5000 
bytes. 


lALL TA1 7,4,8000<CR> Creates four new files on tape unit 1, 

beginning with file 7. Each new file contains 
8000 bytes. 
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In addition to the <number> new files created, an ALLOCATE command attaches a file 
called LAST immediately after the last newly created file. The LAST file is always 768 
bytes long. It marks the logical end of the file structure on the tape. If new files are 
allocated in the middle of an existing file structure, all the old Information on the tape from 
file <beg file> to the end of the tape Is lost, even If the newly ALLOCATEd space is 
shorter than previously ALLOCATEd space. Suppose you have 10 files of 5000 bytes 
each on the tape In tape unit 1: 


HEADER 

FILE 1 

FILE 2 

FILE 3 

FILE 4 

FILES 

FILES 

FILE? 

FILES 

FILES 

FILE 10 

LAST 


The command 


IALLTA1 4,3,5000<CR> 


creates new files 4,5, and 6 (destroying the old files 4, 5, and 6) and attaches a LAST file 
Immediately following file 6: 


HEADER 

FILE1 

FILE 2 

FILE 3 

FILE 4 

FILES 

FILES 

LAST 

(OLD) 

(OLD) 

(OLD) 

(OLD) 

(NEW) 

(NEW) 

(NEW) 

(NEW) 


OLD FILES SAVED 


NEW FILES CREATED 


7 I FILES I FILES { FILE 10 I LAST I 
I) I (OLD) I (OLD) I (OLD) I (OLD) I 


OLD INFORMATION 
NO LONGER ACCESSIBLE 


The tape now contains six files. Even though old files 8-10 and part of old file 7 are still 
magnetically recorded on the tape, this information is no longer accessible. 
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DIRECTORY Command (Requires Option 4) 

When information has been stored on a tape, it wili be necessary at times to examine the 
fiie structure on the tape (perhaps to recall how many files have already been created). 
The DIRECTORY command allows you to do this. 


Syntax 

IDiRectory <tape device>[<output device>]<CR> 
where: 

<tape device> specifies a tape unit. 

<output device> specifies a non-GPIB device. If this parameter is not specified, it 
defaults to M (monitor). 


Action 

This command outputs fiie header information stored on the tape in the tape unit 
specified by <tape device>. The information on this tape must be recorded in 4051- 
compatibie format. (Flies recorded in 4923-compatible format do not contain file header 
information.) This information is recorded on the device specified by the <output 
device> parameter. This output device must be a non-GPIB device. Each file header lists 
the file number, the file type, and the length of the file. 

There are three types of files: a NEW file is one which has been marked on the tape, but 
no information has yet been recorded in it; a file with information recorded in it is an 
ASCII DATA file; the LAST file marks the logical end of the tape file structure. 

Even though file lengths are ALLOCATEd in terms of bytes, the DIRECTORY command 
lists file lengths in blocks. In 4051-compatible format, a block consists of 256 bytes. 
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Examples 

The command 

IALLTA1 0,5,5000<CR> 


initializes the tape and creates five files of 5000 bytes each, as well as a sixth file, LAST. 
Suppose data Is entered in files 1, 2 and 3, and one of the following commands is given: 


IDIR TA1 M<CR> 


or 


!DIRT<CR> 


The following list is displayed in the monitor; 


1 

ASCII 

DATA 

20 

2 

ASCII 

DATA 

20 

3 

ASCII 

DATP 

20 

4 

NEW 


20 

5 

NEW 


20 

6 

LAST 


3 


Note that a LAST file Is always three blocks (768 bytes) long. 


The command: 


!DIRTA2P<CR> 


prints tape unit 2 file headers on the printer. 
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KILL Command 

When a (4051-compatible) file is first created, its file header reads NEW, meaning that the 
file exists but no information is recorded in it (except the file header information). When 
information is stored in that file, its file header is changed to ASCII DATA. 

An ASCII DATA file can be restored to its NEW status by the KILL command. 


Syntax 

IKILI <tape unit.file number><CR> 


Example 

If you wish to restore file 6 on the tape in tape unit 1 to its NEW status, give the command: 
!KILTA1.6<CR> 

This restores the file header for that file to NEW and any information stored in the file is 
lost. 
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PASS Command (Requires Option 4) 

The 4027 can display graphs and text on a Tektronix 4662 Interactive Digital Plotter. The 
4027 has a vocabulary of commands for creating graphic displays. (See the Graphics 
section.) The plotter also has a vocabulary of commands for creating graphic displays. 
This plotter language includes more graphic capabilities than the 4027 language, and the 
formats of the two languages are different. Table 11 -2 gives a summary of the plotter- 
command language. 

Ultimately, any command to which the plotter responds must be in plotter command 
language. The 4027 is designed so that the user can specify graphic commands destined 
for the plotter in either of two ways. 

1. Create a file of plotter-language commands and send that file to the plotter via the 
4027. 

This method has the advantage of using the full range of plotter commands: 
however, it has two disadvantages. First, such a command file can be used only 
for drawing graphs on the plotter. Since the 4027 does not understand plotter- 
language commands, this file is meaningless to it. Second (and more serious), the 
plotter language uses the ASCII <ETX> (end-of-text) character. Being a control 
character, it will not be displayed or Inserted in the 4027 workspace unless the 
4027 is in snoopy mode. The <ETX> character is also used frequently in 
communications with the host computer. Transmitting a plotter-language com¬ 
mand file containing <ETX>s to or from some computers may cause unintended 
results. 

2. Create a command file of 4027 graphic commands and send that file to the plotter, 
instructing the 4027 to translate these 4027 commands into plotter commands. 

This method has the advantage that the command file thus created can be used to 
display the same graph both in the 4027 workspace and on the plotter. Such a file 
is easily transmitted to and from the computer with no troublesome control 
characters. 

This method has a disadvantage, however. Since the plotter’s vocabulary of 
graphic commands is larger and more versatile than that of the 4027, a command 
file using only 4027 commands cannot use the full range of the plotter’s graphic 
capabilities. 

To send 4027-style command files to the plotter, use the COPY command with the /P 
switch setting. (See the COPY discussion later in this section.) To send plotter-style 
commands which have no 4027 equivalents, use the PASS command. 
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The PASS command allows you to transmit plotter style commands to the plotter, without 
the 4027 trying to interpret them as 4027 commands and translating them. 


Syntax 

IPASs <string><CR> 
where <string> can be: 

• A delimited ASCII string. 

• One or more ADE values. 

• A combination of the above. 

Table 11 -2 gives a summary of the plotter command vocabulary. Table 11 -3 illustrates 
how various plotter commands are transmitted using the PASS command. 


Table 11 -2 

PLOTTER LANGUAGE COMMANDS 


Command 

Action 

H<CR> 

Home. Moves the pen to the upper left 

or 

corner of the plotting area. 

H<ETX>a 


M 50,75<CR> 

Move. Moves the pen to the point (50,75) 

or 

in the plotter system of coordinates'*. 

M50,75<ETX> 


D 100,50<CR> 

Draw. Draws a line from the current pen 

or 

position to the point (100,50) in the plotter’s 

D100,50 <ETX> 

system of coordinates. 

D 100,50 0,0 50,10<Cr> 

Draws a line from the current pen position to 

or 

the point (100,50); from there, to the point 

D100,50,0,0,50,10<ETX> 

(0,0); and from there, to (50,10). 
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Table 11-2 (Cent.) 
PLOTTER LANGUAGE COMMANDS 


Command 

Action 

PThis is a test.<ETX> 

Print. Prints on the plotter, starting at the 
current pen position, the message “This is a 
test.” 

S 1.5,3.0<CR> 

Aipha Scaie. Sets the size of each charac- 

or 

ter cell to 1.5 graphic display units in the X- 

S1.5,3.0<ETX> 

direction and 3.0 graphic display units in the 
Y-direction. (The “graphic display unit” is a 
measure of length used by the plotter. In the 
X-direction, it is 1 /^ 50 the iength of the 
plotting area; in the Y-direction, it is 1 /100 
the height of the plotting area.) 

R 10<CR> 

Alpha Rotate. Sets the angle at which 

or 

alphanumeric characters are printed on the 

R10<ETX> 

plotting surface. Characters printed after 
this command is executed slant upwards at 
ten degrees with respect to the positive X- 
axis. 

F 2<CR> 

Alpha Font. Selects printing font number 2 

or 

from among the plotter’s seven fonts. 

F2<ETX> 


A<CR> 

Alpha Reset. Resets the alphanumeric 

or 

printing parameters (Alpha Scale, Alpha Ro¬ 

A<ETX> 

tate, Alpha Font) to their default values. 

T 0<CR> 

Prompt Light. Turns off the PROMPT light 

or 

on the plotter’s front panel. 

T0<ETX> 


T1<CR> 

Turns on the plotter’s PROMPT light. 

or 


T1<ETX> 



^To send an <ETX> or <CR> in a PASS command, it must be put in as an ADE value, since control 
characters are not allowed in delimited strings. 


^The plotter’s coordinate system is not the same as the 4027’s coordinate system. The plotter’s X-axis 
always runs from 0 to 150, and its Y-axis runs from 0 to 100. 
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Table 11 -3 

TRANSMITTING PLOTTER COMMANDS USING PASS 


Command 

Name 

Plotter Language 

4027 Language 

HOME 

H<CR> 

H<ETX> 

IPASS “H”,13<CR> 
!PASS“H”.3<CR> 

MOVE 

M 50,75<CR> 
M50,75<ETX> 

IPASS “M 50,75”,13<CR> 

IPASS “M50,75”,3<CR> 

DRAW 

D100,50<ETX> 

D100,50,0,0<ETX> 

IPASS “D100,50”,3<CR> 

IPASS “D100,50,0,0”,3<CR> 

MOVE, 
followed 
by DRAWa 

M50,75 D100,100<ETX> 

IPASS “M50,75” “D100,100”,3 

IVEC 213,30,427,479<CR> 

PRINTS 

PThis is a test.<ETX> 

IPASS“PThis is a test.”,3<CR> 
ISTRING “This is a test.”<CR> 

ALPHA SCALE 

S1.5,3.0<ETX> 

IPASS “S1.5,3.0”,3<CR> 

ALPHA ROTATE 

R10<ETX> 

IPASS “R10”,3<CR> 

ALPHA FONT 

F2<ETX> 

IPASS “F2”,3<CR> 

ALPHA RESET 

A<ETX> 

IPASS “A”,3<CR> 

PROMPT LIGHT 

T0<ETX> 

T1 <ETX> 

IPASS “T0”,3<CR> 

IPASS “T1”,3<CR> 


^The coordinates in the 4027-language VECTOR command differ from those in the plotter-language MOVE 
and DRAW commands. In translating VECTOR commands, the 4027 assumes a graphics area with a 
maximum X-coordinate of 639 and maximum Y-coordinate of 479 is to be mapped onto a plotter work area 
with maximum X-coordinate of 150 and maximum Y-coordinate of 100. 

^Only PRINT requires the <ETX> character. All other commands take <ETX> or <CR> 
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COPY Command (Requires Option 3 or 4) 

The 4027 can transfer fiies of information from one device to another by means of the 
COPY command. 

Syntax 

ICOPY <source>[<switches>][<destination>][<switches>]<CR> 


Action 

This command copies the information contained in <source> to <destination>. If the 
<switches> parameter is present, the 4027 receives or transmits information according 
to certain conventions determined by the value of <switches>. The <source> and 
<destination> parameters are shown in Table 11 -4. 


Table 11 -4 

4027 COPY PARAMETERS 


Device 

Mnemonic 

Used As 

Parameter 

Used As 

<source> 

Used As 

<destination> 

4027 Workspace 

Wor WO 

X 

X 

4027 Monitor 

M or MO 

X 

X 

Host Computer 

Hor HO 

X 

X 

Printer 

P or PR 


X 

4662 Plotter 1 and 2 

PL1, PL2 

X 

X 

A file on a given tape unit 

TAn.k 

X 

X 


A particular file on a tape is designated TAn.k (see Table 11 -4). In this notation, n is the 
number of a tape unit (1 <n<4) and k is the number of a file on the given tape unit (e.g., 
TA1.3 or TA3.15). The TA1 mnemonic can be shortened to T; for example, TA1.3 can be 
written T.3. 
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11-22 


If <destination > is not specified, it defaults to W (Workspace). 


Examples 

!COP W H<CR> 

!COP H W<CR> 

!COP W TA1.3<CR> 
!COP W T.3<CR> 

!COP TA3.5 W<CR> 
!COP TA3.5<CR> 

!COP TA3.5 P<CR> 

!COP TA2.15 PL1 <CR> 


Copies the contents of the workspace to the 
host. 

Copies the contents of the host file to the 
workspace. 

Copies the workspace contents to file 3 of 
tape unit 1. 

Copies file 5 of the tape in tape unit 3 to the 
workspace. 

Copies file 5 of tape unit 3 to the printer. 
Copies file 15 of tape unit 2 to plotter 1. 


NOTE 

The COPY operation is non-destructive. The command !COP TA1.3 
W< CR> copies the contents of file 3, tape unit 1 to the workspace, 
leaving that information still stored in file 3 of tape unit 1. 


The <switches> parameter consists of one or more slashes (/), each followed by a single 
letter. Each letter serves as a “switch” which, if present, instructs the 4027 to receive or 
transmit information in a certain way. Each switch is given for a specific purpose and is, 
strictly or loosely, associated with a specific <source> or <destination>. The switches 
and their uses are summarized in Table 11 -5: 


Table 11 -5 

4027 COPY SWITCHES 


Switch 

Use 

/N 

When <source> is the workspace, this switch instructs the 4027 to 
ignore all attribute codes stored in the workspace display list and convert 
all ruling characters to asterisks. In this way, a form containing ruling 
characters can be copied to the printer. 
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Table 11 -5 (Cent.) 

4027 COPY SWITCHES 

Switch 

Use 

/N 

When <destination > is the workspace, this switch instructs the 4027 to 
treat all information coming from <source>, including the command 
character, as text to be displayed. This ailows the 4027 operator to display 
a file containing commands in the workspace for examination and 
modification. Setting this switch is equivalent to pressing COMMAND 
LOCKOUT while the 4027 receives text from the host computer. Once the 
file is displayed in the workspace, however, the 4027 again recognizes the 
command character. To send such a file from the workspace to some other 
<destination > one can do either of two things: 

1. Initiate a file transfer from the workspace (COPY or, if <destination > 
is the host computer, SEND). 

2. If the host is going to echo the data back, simply change the 
command character to a symbol which does not appear in the 
displayed file. Then COPY or SEND as usual. 

/U 

When <source> is the workspace and the workspace holds a form, this 
switch instructs the 4027 to copy data in the unprotected fields only. If a 
form is being filled out repeatedly and you wish to store just the data in the 
form, use this switch. If the workspace holds a form and this switch is not 
set, a COPY operation copies the entire form, including attribute codes and 
data in protected fields. 

If the workspace does not contain a form (no attribute codes inserted in 
the display list), the /U switch has no effect. 

/D 

When <source> is the host computer and <destination> is neither 
workspace nor monitor, this switch instructs the 4027 to display the 
copied file in the workspace. Without this switch set, a file copied from the 
host to file TA1.3, for example, would not be displayed on the screen. /D is 
legal only if <source> is the host. 

/P 

When a file containing 4027 graphic commands is copied with the /P 
switch set, the 4027 translates all VECTOR, RVECTOR, STRING, and PASS 
commands into plotter-command language. Only the boundary of a panel 
created with the POLYGON or RPOLYGON command is drawn on the 
piotter. This enables the same file to be used to create graphs on both the 
4027 and the plotter. /P is legal only if <source> is host or tape. 
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Examples 

Copies the workspace contents to the prin¬ 
ter, ignoring attribute codes and converting 
all ruling characters to asterisks. (Requires 
Option 3) 

Copies the host file to the workspace, print¬ 
ing commands as text rather than executing 
them. 

ICOP W/U TA1.4<CR> If the workspace holds a form, copies data 

from the unprotected fields only to file 4 of 
tape unit 1. (Requires Option 4) 

ICOP H/D TA2.5<CR> Copies the host file to file 5 of tape unit 2, 

displaying this file in the workspace as it is 
copied. (Requires Option 4) 

ICOP TA1.7/P PL1 Copies file 7 of tape unit 1 to the plotter, 

translating all VECTOR, RVECTOR, STRING, 
and PASS commands into plotter-command 
language. (Requires Option 4) 


ICOP W/N P<CR> 


ICOP H/N W<CR> 


It is possible to set more than one switch in a COPY command. The command 
ICOP H/D/P PL1<CR> 

copies the host file to plotter 1, displaying this file in the workspace and translating 4027 
graphic commands into plotter-command language. 
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Auto-incrementing the Tape Unit 

When a particular file on a tape unit is designated in a COPY command, the 4027 
remembers that file number until it is replaced by another file number (or until the 4027 is 
RESET or powered off). If the file number is omitted in a subsequent COPY command, the 
4027 automatically Increments the file number in its memory by one and copies to or from 
that file on the tape. 

This feature is useful in text editing or form fillout. Suppose the operator has created a 
form in the workspace and stored the form on tape unit 1 with the command 

!COP WTA1.1 <CR> 

Suppose the PT (Pad Terminator) key has been programmed to give the command 
ICOP W/U TA1 lERA W<CR> 

The operator fills out the form and presses PT. The 4027 stores the data from the 
unprotected fields in the next available file (file 2) of tape unit 1 and erases the 
workspace. (With the 4027 in form fillout mode, only the data in the unprotected fields is 
erased.) The operator fills out the form again, with different data, and again presses PT. 
Again the 4027 stores the data from the unprotected fields in the next available file (now 
file 3) of tape unit 1 and erases the blanks of the form. The operator proceeds in this way 
as long as necessary. 

As another example, suppose successive pages of text to be edited are stored in files 12- 
27 of tape unit 2. To get the first page into the workspace, give the command 

ICOP TA2.12<CR> 

To get each succeeding page, give the command 
!COPTA2<CR> 

Copying the Workspace to the Plotter 

If the workspace holds a graph, it is tempting to try copying this graph directly to the 
plotter. This cannot be done. The workspace display list does not contain sufficient 
information to translate the graphic information displayed into commands which can 
recreate the graph. If the 4027 is commanded to copy the workspace to the plotter, 
graphic information does not copy. (This is similar to the SEND command.) To obtain 
graphs, you must store somewhere (on a tape or in the host) a command file containing 
the necessary commands to recreate the graph. These cannot be derived from the display 
list. 
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COPYING ON A HARD COPY UNIT 

If the 4027 contains Option 42 (Hard Copy and Video Out), a Tektronix 4632 Video Hard 
Copy Unit (Option 6, Enhanced Gray Scale required) can be used to make copies of the 
workspace, the monitor, or the screen. 

This 4632 Video Hard Copy Unit produces pages of copy approximately 8-1 /2 inches by 
11 inches in size. These copies can show whatever can be displayed on the screen: 
text, control characters in snoopy mode, rulings, alternate character fonts, visual 
attributes (except blinking), and graphs. One or several 34-line “pages” from the 
workspace or the monitor can be copied. The 4632 produces gray-scale reproductions of 
the displayed copy aligned with the short axis of the 4027’s display. 

Hard copies are made on the 4632 Video Hard Copy Unit with the HCOPY command. 


HCOPY (Hard Copy) Command (Requires Option 42) 


Syntax 

IHCOpy [<count>][Workspace | Monitor |Screen]<CR> 
where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 

If M (monitor) or W (workspace) is specified, this command copies <count> “pages” 
from the specified scroll to a Tektronix 4632 Video Hard Copy Unit. The copy begins with 
the first visible line in that scroll. Each “page” of copy continues until it includes 34 lines 
of text or until an ASCII <FF> character appears in column 1 of a line. The line of text 
containing such a form feed is not copied. If the specified scroll contains fewer than 
<count> pages, only the number of pages in the scroll is copied. If one attempts to make 
a hard copy of a blank scroll, one (blank) page of hard copy will be produced. 

If S (screen) is specified, <count> is ignored and one copy of the visual screen display, 
both workspace and monitor windows, is made. 

If the HCOPY command comes from the computer and neither W nor M nor S is specified, 
pages are copied from whichever scroll receives text from the computer. 

If the HCOPY command is typed on the keyboard and neither W nor M nor S is specified, 
pages are copied from whichever scroll receives text from the keyboard. 
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Examples 

!HCO 3 W<CR> Copies three “pages” from the workspace to 

the Hard Copy Unit. The first page copied 
begins with the first iine visibie in the 
workspace. 

NOTE 


This means one copy each of three consec¬ 
utive pages in the workspace scroii, not 
three copies of the same page, if the work¬ 
space contains oniy one page, then oniy one 
sheet of copy is produced. 

!HCO M<CR> Copies one page from the monitor to the 

Hard Copy Unit. This page begins with the 
first line visibie in the monitor. 

!HCO S<CR> Copies all information displayed on the 

screen to the Hard Copy Unit. 

!HCO<CR> If this command comes from the computer, 

copies a page from the scroll which receives 
text from the computer. 

If this command is typed on the keyboard, 
copies a page from the scroll which receives 
text from the keyboard. 
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Example 1 


60^* Magenta 


Red 120° 


140 


160 


Yellow 180° 


200 


320 


220 


300° Cyan 


Green 240° 


260 " „ 280 
90 " 


L = 56~l 


L = 43_l 
L = 42“7 


HUE (H) 0-360° 
LIGHTNESS (L) 0-100% 
SATURATION (S) 0-100% 


Example 1: 

IMAP C2 240 50 33 
(H) (L) (S) 


•Note: 


180 " 


150 " 


L = 14 


L = 29 


L = 28 


210 " 


330 " 


240 " 

120 " 


270 " 


180 " 


240 " 


300 " 


The lightness planes (L) shown on the scale are for 
S = 100%. If S = 0% the lightness planes will be: 
L = 71 -100 (white) 

L = 43 - 70 (light grey) 

L = 14 - 42 (dark grey) 

L = 0 - 13 (black) 
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Overview: 

The world of color is filled with ambiguous 
terminology, i.e. intensity, purity, value, etc. 
Many color users feel that "color theory” is a 
prerequisite to operating color systems; T.V., 
Videotaping, Photography, Computer Graph¬ 
ics. 

In order to end this confusion, Tektronix has 
developed a color language and function 
based on human engineering, rather than 
machine engineering. Below is a description 
of this system, which will provide a clear 
and concise means for understanding how 
color is defined and how our syntax was 
derived. 

4027 Color Concepts: 

Color selection is specified by hue, light¬ 
ness and saturation which is the HLS 
method. The definitions are as follows: 

Hue: The characteristic associ¬ 

ated with a color name 
such as red, yellow, green, 
blue, etc. Hue is a grada¬ 
tion of color advanced by 
degrees, thus represented 
as an angle from 0 to 360. 

Lightness: 


Saturation: The characteristic which 

describes the extent to 
which a color differs from 
a gray of the same light¬ 
ness. Saturation is ex¬ 
pressed as percentage, 
ranging from 0% (maxi¬ 
mum white content at that 
lightness level) to 100% 
(full saturated). 

Geometrically, colors can be described in 
terms of a double cone (see Figure 1). 
Variations in lightness are represented 
along the axis, with white at the apex of 
the cone and black at the opposite apex. 
Variations in saturation are represented by . 
radial distances from the lightness axis, in ^ 
constant lightness planes. Hue is repre¬ 
sented as an angular quantity from a known 
reference point. 

The 64 colors available in the 4027 are 
discrete samples from this continuous color 
space. They are obtained by intersecting the 
cone into several planes of constant light¬ 
ness. 


The characteristic that al¬ 
lows the color to be 
ranked on a scale from 
dark to light. Lightness is 
expressed as a parameter 
ranging from 0 to 100% 
with black being 0 (bot¬ 
tom of cone) and white 
being 100% (top of cone). 
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A better understanding of the color standard can be had by looking at a cross section of 
the double-ended cone (Figure A-2). There are four gray levels along the middle of the 
cone. At 0% saturation the four levels of gray are black, dark gray, light gray, and white. At 
any other value of saturation, different hues (color mixtures) are obtained. Hue has no 
effect at 0% saturation. A maximum of seven different “planes” of color can be obtained at 
any value of saturation except 0%. 



Figure A-2. Cross Section of the 4027 Color Standard 
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THE ASCII CODE 


Table B-1 


ASCII CODE CHART 


'^6 

B5 

BITS 

B4 B3 B2 B1 



0 






CONTROL 

HIGH X & Y 
GRAPHIC INPUT 

LOW X 

LOW Y 

0 

0 

0 

0 

NUL 

0 

OLE 

16 

SP 

32 

0 

48 

64 

P 

80 

\ 

96 

P 

112 

0 

0 

0 

1 

SOH 

1 

DCl 

17 

1 

33 

1 

49 

A 

65 

Qa, 

a 

97 

q 

113 


0 

1 

L 

0 

STX 

2 

DC2 

18 

n 

34 

2 

50 

B 

66 

R 

82 

b 

98 

r 

114 

0 

0 


1 

ETX 

3 

DC3 

19 

# 

35 

3 

51 

C 

67 

S 

83 

c 

99 

s 

115 


1 

0 

0 

EOT 

4 

DC4 

20 

$ 

36 

4 

52 

D 

68 

T 

84 

d 

100 

t 

116 

I 

1 

0 

1 

ENQ 

5 

NAK 

27 

% 

37 

5 

53 

E 

69 

U 

85 

e 

101 

u 

117 

B 

1 

1 

_ 

0 

ACK 

6 

SYN 

22 

& 

38 

6 

54 

F 

70 

V 

86 

f 

102 

V 

118 

0 

1 


1 

BEL 

7 

ETB 

23 

/ 

39 

7 

55 

G 

71 

W 

87 

g 

103 

w 

119 

1 

0 

0 

0 

BS 

8 

CAN 

24 

( 

40 

8 

56 

H 

72 

X 

88 

h 

104 

X 

120 

1 

0 

0 

1 

HT 

9 

EM 

25 

) 

41 

9 

57 

1 

73 

Y 

89 

i 

105 

y 

121 


0 

1 

0 

LF 

10 

SUB 

26 

* 

42 

■ 

■ 

58 

J 

74 

Z 

90 

j 

106 

I 

122 


0 

1 

1 

VT 

11 

m 

GO 

'si 

+ 

43 

■ 

5 

59 

K 

75 

[ 

91 

k 

107 

{ 

123 


1 

0 

0 

FF 

12 

FS 

28 

5 

44 

< 

601 

L 

76 

\ 

92 

1 

108 

1 

1 

124 


1 

0 

1 

CR 

13 

GS 

29 

45 

6) 

M 

77 

] 

93 

m 

109 

} 

125 


B 


0 

SO 

14 

RS 

30 

j 

■ 

46 

> 

62 

N 

78 

A 

941 

n 

110 

126 


B 


1 

SI 

15 

US 

31 

/ 

47\ 

? 

63j 

0 

79 

~ 95! 

0 

111 

RUBOUT 

(DEL) 

727 
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Table B-2 

ASCII CONTROL CHARACTERS 



Usual 

ASCII 



Mnemonic 

Abbrev. 

Name of Character 

Keys to Press 

N 

U 

NUL 

Null 

CRTL- @ 

S 

H 

SOH 

Start of Heading 

CTRL-A 

S 

X 

STX 

Start of Text 

CTRL-B 

E 

X 

ETX 

End of Text 

CRTL-C 

E 

T 

EOT 

End of Transmission 

CTRL-D 

E 

Q 

ENQ 

Enquiry 

CTRL-E 

A 

K 

ACK 

Acknowledgement 

CTRL-F 

B 

L 

BEL 

Bell 

CTRL-G 

B 

S 

BS 

Backspace 

CTRL-H 

H 

T 

HT 

Horizontal Tab 

CTRL-1 

V 

LF 

Line Feed 

CTRL-J 

V 

T 

VT 

Vertical Tab 

CTRL-K 

F 

F 

FF 

Form Feed 

CTRL-L 

C 

R 

CR 

Carriage Return 

CTRL-M 

S 

0 

SO 

Shift Out 

CTRL-N 

S 

1 

SI 

Shift In 

CTRL-0 

D 

L 

DLE 

Data Link Escape 

CTRL-P 

D 

1 

DC1 

Device Control 1 

CTRL-Q 

D 

2 

DC2 

Device Control 2 

CTRL-R 

3 

DC3 

Device Control 3 

CTRL-S 

D 

4 

DC4 

Device Control 4 

CTRL-T 

N 

K 

NAK 

Negative Acknowledgement 

CTRL-U 

S 

Y 

SYN 

Synchronization Character 

CTRL-V 

E 

B 

ETB 

End of Transmission Block 

CTRL-W 

C 

N 

CAN 

Cancel 

CTRL-X 

E 

M 

EM 

End of Medium 

CTRL-Y 

S 

B 

SUB 

Substitute 

CTRL-Z 

E 

C 

ESC 

Escape 

CTRL-( 

F 

S 

FS 

Field Separator 

CTRL-\ 

G 

S 

GS 

Group Separator 

CTRL-] 

R 

S 

RS 

Record Separator 

CTRL-1 

CTRL- A 

(CTRL-up arrow or 
CTRL-circumflex 




accent) 

U 

s 

US 

Unit Separator 

CTRL-- 

(CTRL-underscore) 
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Table C-1 

4010-STYLE GRAPHICS CODE CHART 


Low Order X 


Low Order Y 

ASCII 

DEC. 




X or Y Coordinate 




DEC. 

ASCII 

@ 

64 

0 

32 

64 

96 

128 

160 

192 

224 

96 


A 

65 

1 

33 

65 

97 

129 

161 

193 

225 

97 

a 

B 

66 

2 

34 

66 

98 

130 

162 

194 

226 

98 

b 

C 

67 

3 

35 

67 

99 

131 

163 

195 

227 

99 

c 

D 

68 

4 

36 

68 

100 

132 

164 

196 

228 

100 

d 

E 

69 

5 

37 

69 

101 

133 

165 

197 

229 

101 

e 

F 

70 

6 

38 

70 

102 

134 

166 

198 

230 

102 

f 

G 

71 

7 

39 

71 

103 

135 

167 

199 

231 

103 

g 

H 

72 

8 

40 

72 

104 

136 

168 

200 

232 

104 

h 

1 

73 

9 

41 

73 

105 

137 

169 

201 

233 

105 

i 

J 

74 

10 

42 

74 

106 

138 

170 

202 

234 

106 

j 

K 

75 

11 

43 

75 

107 

139 

171 

203 

235 

107 

k 

L 

76 

12 

44 

76 

108 

140 

172 

204 

236 

108 

1 

M 

77 

13 

45 

77 

109 

141 

173 

205 

237 

109 

m 

N 

78 

14 

46 

78 

no 

142 

174 

206 

238 

110 

n 

0 

79 

15 

47 

79 

111 

143 

175 

207 

239 

111 

0 

P 

80 

16 

48 

80 

112 

144 

176 

208 

240 

112 

P 

Q 

81 

17 

49 

81 

113 

145 

177 

209 

241 

113 

q 

R 

82 

18 

50 

82 

114 

146 

178 

210 

242 

114 

r 

S 

83 

19 

51 

83 

115 

147 

179 

211 

243 

115 

s 

T 

84 

20 

52 

84 

116 

148 

180 

212 

244 

116 

t 

U 

85 

21 

53 

85 

117 

149 

181 

213 

245 

117 

u 

V 

86 

22 

54 

86 

118 

150 

182 

214 

246 

118 

V 

w 

87 

23 

55 

87 

119 

151 

183 

215 

247 

119 

w 

X 

88 

24 

56 

88 

120 

152 

184 

216 

248 

120 

X 

Y 

89 

25 

57 

89 

121 

153 

185 

217 

249 

121 

y 

z 

90 

26 

58 

90 

122 

154 

186 

218 

250 

122 

z 

C 

91 

27 

59 

91 

123 

155 

187 

219 

251 

123 

{ 

\ 

92 

28 

60 

92 

124 

156 

188 

220 

252 

124 

, 

] 

93 

29 

61 

93 

125 

157 

189 

221 

253 

125 

} 

A 

94 

30 

62 

94 

126 

158 

190 

220 

254 

126 


_ 

95 

31 

63 

95 

127 

159 

191 

223 

255 

127 


DEC. — 


32 

33 

34 

35 

36 

37 

38 

39 



ASCII — 


SP 

! 

99 

# 

$ 

% 

& 

' 








High OrderX & Y 







INSTRUCTIONS: Find coordinate value in body of chart; follow that column to bottom of chart to find decimal value or 
ASCII character which represents the High Y or High X byte; go to the right in the row containing the coordinate value to 
find the Low Y byte, or go to the left to find the Low X byte. EXAMPLE: 200Y, 48X equals 38 104 33 80 in decimal code, 
and equals & h ! P in ASCII code. 
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4010 GRAPHICS 


Table C-1 (cent) 

4010-STYLE GRAPHICS CODE CHART 


Low Order X 


Low Order Y 

ASCII 

DEC. 




X or Y Coordinate 




DEC. 

ASCII 

@ 

64 

256 

288 

320 

352 

384 

416 

448 

480 

96 


A 

65 

257 

289 

321 

353 

385 

417 

449 

481 

97 

a 

B 

66 

258 

290 

322 

354 

386 

418 

450 

482 

98 

b 

C 

67 

259 

291 

323 

355 

387 

419 

451 

483 

99 

c 

D 

68 

260 

292 

324 

356 

388 

420 

452 

484 

100 

d 

E 

69 

261 

293 

325 

357 

389 

421 

453 

485 

101 

e 

F 

70 

262 

294 

326 

358 

390 

422 

454 

486 

102 

f 

G 

71 

263 

295 

327 

359 

391 

423 

455 

487 

103 

g 

H 

72 

264 

296 

328 

360 

392 

424 

456 

488 

104 

h 

1 

73 

265 

297 

329 

361 

393 

425 

457 

489 

105 

i 

J 

74 

266 

298 

330 

362 

394 

426 

458 

490 

106 

j 

K 

75 

267 

299 

331 

363 

395 

427 

459 

491 

107 

k 

L 

76 

268 

300 

332 

364 

396 

428 

460 

492 

108 

1 

M 

77 

269 

301 

333 

365 

397 

429 

461 

493 

109 

m 

N 

78 

270 

302 

334 

366 

398 

430 

462 

494 

110 

n 

0 

79 

271 

303 

335 

367 

399 

431 

463 

495 

111 

0 

P 

80 

272 

304 

336 

368 

400 

432 

464 

496 

112 

P 

Q 

81 

273 

305 

337 

369 

401 

433 

465 

497 

113 

q 

R 

82 

274 

306 

338 

370 

402 

434 

466 

498 

114 

r 

S 

83 

275 

307 

339 

371 

403 

435 

467 

499 

115 

s 

T 

84 

276 

308 

340 

372 

404 

436 

468 

500 

116 

t 

U 

85 

277 

309 

341 

373 

405 

437 

469 

501 

117 

u 

V 

86 

278 

310 

342 

374 

406 

438 

470 

502 

118 

V 

w 

87 

279 

311 

343 

375 

407 

439 

471 

503 

119 

w 

X 

88 

280 

312 

344 

376 

408 

440 

472 

504 

120 

X 

Y 

89 

281 

313 

345 

377 

409 

441 

473 

505 

121 

y 

z 

90 

282 

314 

346 

378 

410 

442 

474 

506 

122 

z 

c 

91 

283 

315 

347 

379 

411 

443 

475 

507 

123 

{ 

\ 

92 

284 

316 

348 

380 

412 

444 

476 

508 

124 

1 

] 

93 

285 

317 

349 

381 

413 

445 

477 

509 

125 

} 

A 

94 

286 

318 

350 

382 

414 

446 

478 

510 

126 

~ 

_ 

95 

287 

319 

351 

383 

415 

447 

479 

511 

127 


DEC. - 


40 

41 

42 

43 

44 

45 

46 

47 



ASCII- 


( 

) 

« 

+ 


- 


/ 








HighOrderX& Y 
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Table C-1 (cent) 

4010-STYLE GRAPHICS CODE CHART 


Low Order X | 


Low Order Y 

ASCII 

DEC. 




X or Y Coordinate 




DEC. 

ASCII 

@ 

64 

512 

544 

576 

608 

640 

672 

704 

736 

96 


A 

65 

513 

545 

577 

609 

641 

673 

705 

737 

97 

a 

B 

66 

514 

546 

578 

610 

642 

674 

706 

738 

98 

b 

C 

67 

515 

547 

579 

611 

643 

675 

707 

739 

99 

c 

D 

68 

516 

548 

580 

612 

644 

676 

708 

740 

100 

d 

E 

69 

517 

649 

581 

613 

645 

677 

709 

741 

101 

e 

F 

70 

518 

550 

582 

614 

646 

678 

710 

742 

102 

f 

G 

71 

519 

551 

583 

615 

647 

679 

711 

743 

103 

9 

H 

72 

520 

552 

584 

616 

648 

680 

712 

744 

104 

h 

1 

73 

521 

553 

585 

617 

649 

681 

713 

745 

105 

i 

J 

74 

522 

554 

586 

618 

650 

682 

714 

746 

106 

j 

K 

75 

523 

555 

587 

619 

651 

683 

715 

747 

107 

k 

L 

76 

524 

556 

588 

620 

652 

684 

716 

748 

108 

1 

M 

77 

525 

557 

589 

621 

653 

685 

717 

749 

109 

m 

N 

78 

526 

558 

590 

622 

654 

686 

718 

750 

110 

n 

0 

79 

527 

559 

591 

623 

655 

687 

719 

751 

111 

0 

P 

80 

528 

560 

592 

624 

656 

688 

720 

752 

112 

P 

Q 

81 

529 

561 

593 

625 

657 

689 

721 

753 

113 

q 

R 

82 

530 

562 

594 

626 

658 

690 

722 

754 

114 

r 

S 

83 

531 

563 

595 

627 

659 

691 

723 

755 

115 

s 

T 

84 

532 

564 

596 

628 

660 

692 

724 

756 

116 

t 

U 

85 

533 

565 

597 

629 

661 

693 

725 

757 

117 

u 

V 

86 

534 

566 

598 

630 

662 

694 

726 

758 

118 

V 

w 

87 

535 

567 

599 

631 

663 

695 

727 

759 

119 

w 

X 

88 

536 

568 

600 

632 

664 

696 

728 

760 

120 

X 

Y 

89 

537 

569 

601 

633 

665 

697 

729 

761 

121 

y 

z 

90 

538 

570 

602 

634 

666 

698 

730 

762 

122 

z 

c 

91 

539 

571 

603 

635 

667 

699 

731 

763 

123 

{ 

\ 

92 

540 

572 

604 

636 

668 

700 

732 

764 

124 

1 

] 

93 

541 

573 

605 

637 

669 

701 

733 

765 

125 

} 

A 

94 

542 

574 

606 

638 

670 

702 

734 

766 

126 



95 

543 

575 

607 

639 

671 

703 

735 

767 

127 


DEC — 


48 

49 

50 

51 

52 

53 

54 

55 



ASCII — 


0 

1 

2 

3 

4 

5 

6 

7 








High OrderX & Y 
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Table C-1 (cent) 

4010-STYLE GRAPHICS CODE CHART 


Low Order X 


Low Order Y 

ASCII 

DEC. 




X or Y Coordinate 




DEC. 

ASCII 

@ 

64 

768 

800 

832 

864 

896 

928 

960 

992 

96 

% 

A 

65 

769 

801 

833 

865 

897 

929 

961 

993 

97 

a 

B 

66 

770 

802 

834 

866 

898 

930 

962 

994 

98 

b 

C 

67 

771 

803 

835 

867 

899 

931 

963 

995 

99 

c 

D 

68 

772 

804 

836 

868 

900 

932 

964 

996 

100 

d 

E 

69 

773 

805 

837 

869 

901 

933 

965 

997 

101 

e 

F 

70 

774 

806 

838 

870 

902 

934 

966 

998 

102 

f 

G 

71 

775 

807 

839 

871 

903 

935 

967 

999 

103 

9 

H 

72 

776 

808 

840 

872 

904 

936 

968 

1000 

104 

h 

1 

73 

111 

809 

841 

873 

905 

937 

969 

1001 

105 

i 

J 

74 

778 

810 

842 

874 

906 

938 

970 

1002 

106 

j 

K 

75 

779 

811 

843 

875 

907 

939 

971 

1003 

107 

k 

L 

76 

780 

812 

844 

876 

908 

940 

972 

1004 

108 

1 

M 

77 

781 

813 

845 

877 

909 

941 

973 

1005 

109 

m 

N 

78 

782 

814 

846 

878 

910 

942 

974 

1006 

110 

n 

0 

79 

783 

815 

847 

879 

911 

943 

975 

1007 

111 

0 

P 

80 

784 

816 

848 

880 

912 

944 

976 

1008 

112 

P 

Q 

81 

785 

817 

849 

881 

913 

945 

977 

1009 

113 

q 

R 

82 

786 

818 

850 

882 

914 

946 

978 

1010 

114 

r 

S 

83 

1^1 

819 

851 

883 

915 

947 

979 

1011 

115 

s 

T 

84 

788 

820 

852 

884 

916 

948 

980 

1012 

116 

t 

U 

85 

789 

821 

853 

885 

917 

949 

981 

1013 

117 

u 

V 

86 

790 

822 

854 

886 

918 

950 

982 

1014 

118 

V 

w 

87 

791 

823 

855 

887 

919 

951 

983 

1015 

119 

w 

X 

88 

792 

824 

856 

888 

920 

952 

984 

1016 

120 

X 

Y 

89 

793 

825 

857 

889 

921 

953 

985 

1017 

121 

Y 

z 

90 

794 

826 

858 

890 

922 

954 

986 

1018 

122 

z 

[ 

91 

795 

827 

859 

891 

923 

955 

987 

1019 

123 

{ 

\ 

92 

796 

828 

860 

892 

924 

956 

988 

1020 

124 


] 

93 

797 

829 

861 

893 

825 

957 

989 

1021 

125 

} 

A 

94 

798 

830 

862 

894 

926 

958 

990 

1022 

126 


_ 

95 

799 

831 

863 

895 

927 

959 

991 

1023 

127 


ncr _^ 1 

56 

57 

58 

59 

60 

61 

62 

63 







A cr* 11 


8 

9 



< 


> 

? 



r-\0^ 1 1 



$ 









High Order X & Y 
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ALTERNATE FONTS 


Table D-2 

RULING JUNCTIONS CHART 


Rulings Standard 

(Fonti) (FontO) 



rtYGYYWYYYYYB 
[ _ C [ 

t _ [ [ 

HYYOYYIYYYYYJ 
C _ [ [ 

C _ [ [ 

[ _ t [ 

PYYWYYOYYYYYR 

D]]C]]E]]]]]F 

- C _ 

XYYIYYOYYYYYZ 
_ [ _ 

L]]K]]M]]1]]N 

- C _ 

- C _ 

_ [ _ 




I 4024/4025 
f RULINGS 




d))c))e)))))f ^ 
9 [ ? ? 

xYYIYYoYYYYYz 
? [ ? ? 

l))k))m)))))n 
? [ ? ? 

? [ ? ? 

? C ? ? 

t))s))u)))))v 



[ _ C 

C _ [ 

:}))y))}{)))'' 
[ _ [ 

C _ [ 

p3]]3]]]U]]]r 


I 4027 
f RULINGS 


? 

- ? _ 
XYYYYYoYYYYYX 
? 

? 

qYYYYYwYYYYYl 
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Appendix E 


SAMPLE PROGRAMS 


This appendix contains three sample programs for the 4027 Color Graphics Terminal. The 
first is a program written in BASIC which allows the operator to sample the 64 colors of 
the terminal. The second is a short program (actually a segment of a larger program) in 
PASCAL which processes the input to the host from a !REP 00 command. The third is a 
complete COBOL program which displays a form in the terminal workspace and stores 
the data from the form in a file. 


THE BASIC PROGRAM 


The program which follows is written to demonstrate the 64 color mixtures available on 
the terminal. The program allows the operator to move the graphic cursor to any position 
on the center plane of the color cone. Any one position on this plane represents the 
<hue>, <lightness>, and <saturation> parameters of a MAP command. The second 
parameter, <lightness>, varies the color created by the other two parameters. The 
program displays all seven variations on the lightness plane with <hue> and 
<saturation> remaining constant. 


1 11 = 20 

4 x=168 

5 y=200 

6 r=100 

7 t=5 

9 !goto setup subroutin 

10 gosub 8000 

16 12=34 

17 13=48 

18 14=62 

19 15=74 

990 rem Enable cross-hair,turn off ink, and input a point 

998 print "!ena" 

999 print "!ink n" 

1000 print"!era m!rep 03" 

1005 input d1 $,k1,X1,d2$ 

1006 on error goto 1000 

1007 y1=val(left(d2$,(len(d2$)-1))) 

1009 if x1=0 then goto 9000 

1010 x2=x1-x 
1015 y2=y1-y 

1020 if x2=0 then x2=.001 

1022 rem If cross-hair is not in the circle then get another point 
1025 if sqr((x2*x2)+(y2*y2))>r then goto 1000 

1030 h=fix(atn(y2/x2)/k) 

1031 if x2<0 then h=h+180 

1032 if h<0 then h=h+360 

1035 s=fix(sqr((x2*x2)+(y2*y2))*100/r) 

1050 gosub 2000 
1055 goto 1000 
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SAMPLE PROGRAMS 


2000 !color output routine 


2005 

print" 

! map 

cl " 

h;11 ; s 

2010 

print" 

! map 

c2 " 

h;12;s 

2015 

print" 

!map 

c3 " 

h ;13;s 

2020 

print" 

! map 

c4 " 

h;14;s 

2025 

print" 

!map 

c5 " 

h;15;s 

2030 

print" 

! wor 

h!jum 8 8" 


2032 print"Hue=";hSaturation:s 
2035 print"!mon h" 

2040 return 

8000 !seup routine 

8001 print"!map cO 0 0 Olmap c7 0 50 0!map c6 0 100 0" 

8002 print"!wor 30!gra 1 30" 

8003 k=6.28/360 
8005 Idraw circle 
8009 print "!col cO" 

8021 print "!vec ";x;y;"!cir ";r 

8022 print "!cir ";r/2 

8023 print "iline 2" 

8024 for i=15 to 345 step 30 

8025 print"!vec";fix(r/2*cos(i*k))+x;fix(r/2*sin(i*k))+y; 
fix(r*cos(i*k))+x;fix(r*sin(i*k))+y/l 


8026 next i 

8027 print "!line 1" 

8028 for i=10 to 350 step 20 
8 O 3 O print "!vec "; 

8 O 35 print fix(r/2*cos(i*k))+x;fix(r/2*sin(i*k))+y; 

8040 print fix((r+t)*cos(i*k))+x;fix((r+t)*sin(i*k))+y 

8041 next i 

8042 for i=30 to 330 step 60 

8043 print"!vec";x;y;fix(r*cos(i*k))+x;fix(r*sin(i*k))+y 


8044 

8047 

8048 
8050 
8055 
8060 
8065 

8099 

8100 
8105 
81 10 
8115 
8120 
8125 
8I3O 
81 35 
8140 
8145 
8150 

8999 

9000 
9001 
9999 


nex t i 


t1=y-r-75 
t2=y-r-25 
for i=0 to 6 

print'Mcol c" ; chr$ ( i + 48); " cO" 

print’Mpol " ; 336; 11+ i*50 ; 600; 11+ i»50 ; 600; 12+i*50; 336; 12+i»50 
nex t i 


print" 

! wor 

h" 


print" 

! jum 

2 

38;Lightness 

print" 

! jum 

4 

39;100" 

print" 

! jum 

7 

40;83" 

print" 

! jum 

1 1 

40;67" 

print" 

! jum 

1 4 

40;55" 

print" 

! jum 

18 

4 0; 4 1 " 

print" 

! jum 

21 

40-, 27" 

print" 

! jum 

25 

40; 13" 

print" 

! jum 

29 

41 ;0" 

print" 

! mon 

h" 


print" 

! jum 

It 


retur n 




print 

"!disa" 


stop 




end 





tf 
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SAMPLE PROGRAMS 


THE PASCAL PROGRAM 

The following PASCAL program issues a !REP 00; command to the terminal, analyzes the 
ANSwer to the host, and returns the terminal status indicated by ANSwer. (See the 
REPORT command discussion in the Host Programming for the 4027 section.) 

{$t-,d-} 

{*** REPORT 

This will read the data returned from the terminal for the 
various REPort commands } 

VAR No__more_to_do : boolean; 

PROCEDURE Convert_number(VAR number :integer); 

{ This will convert the ASCII character string being input 

by the terminal to INTEGER format. Any non-numeric character 
terminates the conversion process. The default value is 0 } 

BEGIN 

number := 0; { set up default value } 

WHILE tty'' in [»0*..»9*] DO BEGIN 

number := number*10 + (ord( tty'')-48); 
get(tty) 

END; {of while} 

END; { converting a number } 


PROCEDURE Report_1; 

{ This will inquire about the system itself } 

VAR Blocks 
,Bytes 

,Status 

: integer; 

BEGIN 

Write (tty,Mrep 00; M; 1 Issue report request } 

Break; Reset(tty); 

WHILE tty'' # M* DO get(tty); { Search for command character } 

FOR i := 1 to 6 DO get(tty); { Skip over to the type of ans } 

IF tty'' # *0’ THEN Writein (tty,’<< ANS not of proper type >>*) 

ELSE BEGIN 

getCtty); get(tty); { skip commas } 

convert_number(blocks); { get blocks free } 

write (tty,blocks:4,’=Blocks/’); 

bytes := blocks^l6; { convert blocks to bytes } 

write (tty,bytes:5,* =Bytes Available*); 
get(tty); { skip comma } 

convert_number(status); 

CASE status OF 

1 : Write (tty,* < Buffered >*); 

2 : Write (tty,* < Form Fill out >*); 

3 : Write (tty,* < Buffered & Form Fill out >*); 

4 : Write Hty,* < Monitor Present >*); 

5 : Write (tty,* < Buffered & Monitor Present >*); 

6 : Write (tty,* < Form Fill out & Monitor Present >*); 

7 : Write (tty,* < Monitor, Form, & Buffered >*) 

END; { of CASE } 

END (If then ELSE) 

END; (report 1} 
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BEGIN 

Rewrite (ttyoutput); { Open tty communications } 

No_more__to_do := true; { initz } 

REPEAT 

Report_1; 

no_more_to__do := true 
UNTIL no_more_to_do 

END. 


THE COBOL PROGRAM 

The program which follows is written in COBOL and demonstrates the use of form fillout 
and buffering. The program could have been written in any language which supports 
some way of writing to and reading from the display character type information. 


Design Objectives 

Because COBOL works best with defined fields of fixed length and because the 1968 
COBOL standard has no string handling verbs, this program was set up to process a field 
at a time instead of a line at a time. 

To make the terminal do this, buffered mode is used and the PROMPT character is 
defined to be the same character used as the line terminator. Here the PROMPT was set 
equal to carriage-return. In this manner the ACCEPT always gets one field. Each field 
contains 7 characters of fixed and always present information about row and column, and 
a variable amount of form data. The amount of form data is variable because trailing 
blanks are not sent. 

This field is ACCEPTED into TERMINAL-DATA which is PICTURed iarge enough to 
contain the largest data field from the form plus seven more characters. 


Analyzing the Input 

The program examines TD-ROW. Once the row is identified, a routine is PERFORMED to 
examine TD-COLUMN. Once the column is identified, a routine is PERFORMED to analyze 
the data. In this program the data analysis simply stores the data in a file. Because data is 
being moved from a larger to smaller field, the compiler will generate warning messages 
telling you of this fact. 
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End of Data From the Terminal 

Since this form does not require ail of its fields to be entered and since the information is 
received and processed a field at a time, line 23 was set up as a protected modified field. 
Therefore, this field is always sent to the host and is sent last. When this field is received, 
the end of the screen has been reached and everything on that screen has been 
processed. An appropriate indicator is set to indicate the end of the buffer. 


Exiting the Program 

To provide an orderly exit from the program, the keyword QUIT is entered into the first 
field of a new screen. The column processor for that line detects QUIT and sets an end of 
job indicator which signals the end to the rest of the program. An exit is made after the 
terminal is returned to a reference state for the next job. 


Synchronous Protocol 

This program was run using asynchronous protocol. If you use a synchronous protocol 
which transmits large amounts of data at once, the program or some routine in the system 
should be assigned the task of reading all the data and placing it into the proper places. 

In this case, the program looks different because the data is all present at once (in a 
manner similar to reading a file). 


000100 

000020 

000300 

000400* 

000500** 

000600** 

000700 ** 

000800** 

000900 

001000 ** 

001100 ** 

001200 ** 

001300 ** 

001400** 

001500 ** 

001600** 

001700 ** 

001800** 

001900 ** 

002000 ** 

002100 ** 

002200 ** 

002300 ** 

002400** 


IDENTIFICATION DIVISION. 

PROGRAM-ID. FORM. 
REMARKS. 


THIS IS A SAMPLE PROGRAM WHICH SENDS A FORM 
TO THE TERMINAL AND PROCESSES THE DATA RETURNED. 

<< INPUT/OUTPUT ASSUMPTIONS >> 

THIS PROGRAM USES THE 'ACCEPT' AND 'DISPLAY' VERBS TO 
COMMUNICATE WITH THE VIDEO TERMINAL. FILE OUTPUT 
IS AS PER USUAL. 

THE INPUT FROM THE TERMINAL IS VARIABLE IN LENGTH WITH 
THE FIRST 7 CHARACTERS ALWAYS PRESENT AND IN THE SAME 
FORMAT. 

FROM TERMINAL: ROW, COL.DATA. 

! ! ! !_ END OF DATA 

! ! ! START OF DATA 

! ! COLUMN DATA STARTS IN 

! ROW DATA STARTS IN 
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002500* 

002600* 

002700 * 

002800* 

002900* 

005200 

005300 

005400 

005500 

005600 

005700 

005800 

005900 

006000 

006500 

006600 

006700 

006800 

006900 

007000 

007200 

007300 

007400 

007500 


THIS PROGRAM WAS ORIGINALLY DEVELOPED ON A DECSYSTEM-10 
AND WITH MODIFICATIONS TO THE »SELECT» AND »FD» STATEMENTS AND 
CHANGING THE *DISPLAY-7’ TO WHATEVER DISPLAY ALLOWS INPUT OF 
OF UPPER AND LOWER CASE CHARACTERS SHOULD CONVERT IT TO 
ANOTHER SYSTEM. 

ENVIRONMENT DIVISION. 

INPUT-OUTPUT SECTION. 

FILE-CONTROL. 


SELECT 


TEK-FORM 

ASSIGN TO DSK 

ACCESS MODE IS SEQUENTIAL 

PROCESSING MODE IS SEQUENTIAL. 


DATA DIVISION. 


FILE SECTION. 


FD TEK-FORM 

VALUE OF ID IS »DATA SEQ* 
DATA RECORD IS TEK-FORM-DATA. 


007600 

01 TEK-FORM. 

-DATA 

USAGE IS 

DISPLAY-7 

007700 

02 

TF-REF 

PIC 

X(10) . 

007800 

02 

TF-CUST. 



007900 


03 TF-CUST-1 

PIC 

X(4) . 

008000 


03 TF-CUST-2 

PIC 

X(10). 

008100 

02 

TF-INSTRUMENT 

PIC 

X(8) . 

008200 

02 

TF-VALUE 

PIC 

X(8) . 

008300 

02 

TF-TYPE 

PIC 

X(5) . 

008400 

02 

TF-FC-AMOUNT 

PIC 

X(13). 

008500 

02 

TF-RATE 

PIC 

X(12). 

008600 

02 

TF-DOLLARS 

PIC 

X(15). 

008700 

02 

TF-OUR-ACCT 

PIC 

X(4) . 

008800 

02 

TF-CONTRACT-NR 

PIC 

X(8) . 

008900 

02 

TF-CREDIT-REFERENCE 

PIC 

X(12). 

009000 

02 

TF-CHECK-OK 

PIC 

X(1 ). 


011000 


011900 WORKING-STORAGE SECTION. 

012000 

012200 

012300 01 TEK-FORM-FILL-OUT USAGE IS DISPLAY-7. 

012400*======================= 

012500 


012600 

012700 

02 TFFO-0 
»IFOR N;IBUF;IWOR 

24 

PIC 

K H;lJUM;lERA*. 

X(33) 

VALUE 

IS 

012800 

012900 

013000 

02 TFFO-1 
*!JUM;I ATT IP*. 


PIC 

X(12) 

VALUE 

IS 

013100 

013200 

013300 

02 TFFO-1A 
*!JUM 1,11;T C2 

K 

PIC 

X(19) 

VALUE 

IS 

013400 

013500 

013600 

02 TFFO-1B 
*!JUM 1,27;SAMPLE 

OF 

PIC 

FORM FILL OUT *. 

X(33) 

VALUE 

IS 

013700 

02 TFFO-1C 


PIC 

X(27) 

VALUE 

IS 


013800 MJUM 1,79; ! ATT PC0;!JUM 3,1’. 

013900 * 
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014000 02 TFFO-3 PIC X(19) VALUE IS 

014100 '!ATT P;REF !JUM 3,6'. 

014200 

014300 02 TFF0-3A PIC X(27) VALUE IS 

014400 '!ATT C2A; !JUM 3,16'. 

014500 

014600 02 TFF0-3B PIC X(36) VALUE IS 

014700 '!ATT PCO; OUST !ATT C2A; !ATT PCO'. 

014800 

014900 02 TFF0-3C PIC X(27) VALUE IS 

015000 ' !ATT C2A;!JUM 3,39; !ATT PCO'. 

015100 

015200 02 TFF0-3D PIC X(46) VALUE IS 

015300 ' INSTRUMENT !ATT C2A; !ATT PCO;!JUM 3,61'. 

015400 

015500 02 TFF0-3E PIC X(33) VALUE IS 

015600 ' VALUE DT !ATT C2A; !ATT PCO'. 

015700 

015800 » 

015900*LINE 5 
016100 * 

016200 02 TFFO-5 PIC X(55) VALUE IS 

016300 ".JUM 5;!ATT PCO; TYPE !ATT C2A; !JUM 5,17;!ATT PCO'. 

016400 

016500 02 TFF0-5A PIC X(45) VALUE IS 

016600 ' F/C AMT !JUM 5,27;!ATT AC2;!JUM 5,40; !ATT PCO'. 

016700 

016800 02 TFF0-5B PIC X(33) VALUE IS 

016900 ' RATE !ATT C2A;!JUM 5,60; !ATT PCO'. 

017000 

017100 02 TFF0-5C PIC X(30) VALUE IS 

017200 ' $ !ATT C2NIJUM 5,79; '.ATT PCO'. 

017300 

018000* 

018100* LINE 7 
018200* 

018400* 

018500 

018600 02 TFFO-7 PIC X(45) VALUE IS 

018700 '!JUM 7;!ATT PCO; OUR ACCT ! ATT AC2; !ATT PCO'. 

018800 

018900 02 TFF0-7A PIC X(30) VALUE IS 

019000 ' CONT# !ATT AC2; !ATT PCO'. 

019100 

019200 02 TFF0-7B PIC X(46) VALUE IS 

019300 ' CREDIT REFERENCE# 'ATT AC2;!JUM 7,62; !ATT PCO'. 

019400 

019500 02 TFF0-7C PIC X(29) VALUE IS 

019600 ' CHECK OK !ATT AC2; !ATT PCO'. 

019700 

030100 * 

030200* LINE 23: SPECIAL END OF SCREEN DATA FLAG 

030300 * 

030400 02 TFFO-EOD-FLAG PIC X(45) VALUE IS 

030500 '!JUM 23;!ATT PM;01'. 

O 3 O 6 OO* 

030700 * FORM END 
O 3 O 8 OO* 

030900 02 TFFO-END PIC X(13) VALUE IS 

031000 '!JUM 3,6;!FOR'. 

031100 
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031200 01 TERMINAL-DATA 

031300 *================ 

031400 

031500 02 TD-LOCATION. 

031600 03 TD-LOC-ROW 

031700 03 FILLER 

O 3 I 8 OO 03 TD-LOC-COL 

031900 02 TD-DATA 

032000 

032100 01 INDICATORS. 
032200 *============== 

032300 

032400 02 END-OF-JOB-IND 

032500 88 END-OF-JOB 

032600 

032700 02 LINE-IS-EMPTY-IND 

032800 88 LINE-IS-EMPTY 

032900 

033000 01 CONSTANTS. 

033100 *============= 

033200 

033300 02 PROMPT-4025 

033400 

033500 01 VARIABLES. 

033600 * 

033700 
033800 
034090* 

034100 
034200 * 

034400 

034600 
034800 

034900 
035000 
035100 
035200 

035400 

035500 
035700 


USAGE IS DISPLAY-7. 


PIC X(3). 
PIC X. 

PIC X(3). 
PIC X(40) 


PIC X(3). 

VALUE IS 'EOJ'. 

PIC X(3). 

VALUE IS 'EOL'. 


PIC X VALUE IS '?’ . 


PIC 9(2). 

» 




02 TIMES-SCREEN-RESET 
PROCEDURE DIVISION. 


INITIALIZATION. 

OPEN OUTPUT TEK-FORM. 

MOVE SPACES TO TEK-FORM-DATA. 
PERFORM TERMINAL-SET-UP. 
PERFORM DISPLAY-THE-FORM. 


MAIN-PART. 


035900 

036000 MOVE SPACES TO END-OF-JOB-IND. 

036100 PERFORM PROCESS-THE-TERMINAL-DATA UNTIL END-OF-JOB. 

036200* FLUSH THE LINE 23 FIELD STILL BUFFERED UP 
036300 DISPLAY PROMPT-TERMINAL. 

036310 ACCEPT TERMINAL-DATA. 

036320 DISPLAY PROMPT-TERMINAL. 

036330 ACCEPT TERMINAL-DATA. 

036400 CLOSE TEK-FORM. 

036500 PERFORM TERMINAL-SET-DOWN. 

036600 STOP RUN. 

036700* << LOGICAL END OF PROGRAM >> 

037000 PROCESS-THE-TERMINAL-DATA. 

037200 * - 

037200 

037300 MOVE SPACES TO TERMINAL-DATA. 

037400 PERFORM GET-BUFFER-LINE. 

037500 

037600 MOVE SPACES TO LINE-IS-EMPTY-IND 

037700 PERFORM DISASSEMBLE-TERMINAL-INPUT UNTIL 

037800 LINE-IS-EMPTY 
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037900 

038000 

038100 

038200 

038300 

038400 

038500 

038600 

038700* 

038800 

039010 * 

039000 

039120* 

039130* 

039100 * 

039200 * 

039300 * 

039400 * 

039500 

039600 

039700 

039800 

039900 

040000 

040200 

040210* 

040400 

040500* 

040600* 

040700* 

040800* 

040900* 

041000* 

041100* 


IF NOT END-OF-JOB 

WRITE TEK-FORM-DATA 
DISPLAY PROMPT-TERMINAL 
MOVE SPACES TO TEK-FORM-DATA 
DISPLAY PROMPT-TERMINAL 

ELSE 

NEXT SENTENCE. 

DISPLAY '!ERA;!BEL'. 

TERMINAL-SET-UP. 


IT IS BEST TO SET THE TERMINAL TO A KNOWN STATE 
RATHER THAN TO ASSUME WHAT STATE IT IS IN. 

SET PROMPT := <?><CARRIAGE-RETURN><LINE-FEED> 
SET FI ;= <CARRIAGE-RETURN><LINE-FEED> 

SET PT := <SEND MODIFIED> 

SET FIELD-SEPERATOR := <CARRIAGE-RETURN> 


DISPLAY '!PRO 
DISPLAY MLEA 
DISPLAY '!LEA 
DISPLAY MFIE 


63,13,10' . 

FI 13,10'. 

PT /!REP 1;!SEN MOD/13'• 
13' . 


TERMINAL-SET-DOWN. 


PURPOSE: 

RETURN THE TERMINAL TO COMMUNICATION WITH THE HOST, 

THE KEYBOARD TO THE MONITOR SPACE, NON-FORM FILL OUT, 
UNBUFFERED, ALL FUNCTION AND OTHER KEYS UN-LEARNED, AND 
DISPLAY IN THE MONITOR SPACE OF THE TERMINAL A MESSAGE SAYING 
WHAT HAS BEEN DONE. 


041210* IN THIS WAY, IT IS POSSIBLE FOR THE USER TO COMMUNICATE 

041220* WITH THE COMPUTER WITHOUT LOSING THE LAST SCREEN. 

041200 

041300 DISPLAY '!FOR N;!BUF N;!MON K H'. 

041400 DISPLAY 'iCLEAR'. 

041500 DISPLAY '<< END OF TEK FORM FILLOUT EXAMPLE >>'. 

041600 

041800 GET-BUFFER-LINE. 

041810* - 

042000* SINCE INFORMATION IS 'BUFFERED' , IT IS NECESSARY TO 

042010* 'PROMPT' THE TERMINAL TO SEND THE DATA AND THEN WAIT FOR IT TO 
042020* BE SENT. 

042300 

042400 DISPLAY PROMPT-TERMINAL. 

042500 ACCEPT TERMINAL-DATA. 

042510 

043000 DISASSEMBLE-TERMINAL-INPUT. 

043010* - 

043200 

043300* THIS SECTION IS A 'CASE' STATEMENT THAT EXAMINES 

043400* THE DATA FROM THE TERMINAL AND PERFORMS A ROUTINE 
043500* WHICH FURTHER EXAMINES THE LINE. 

043600* 


043700* 

CASE TD-LOC 

-ROW OF 




043800* 

*003’ 

: PERFORM 

ROW 

3 

PROCESSING 

043900 * 

*005’ 

: PERFORM 

ROW 

5 

PROCESSING 

044100* 

* 023 * 

: PERFORM 

ROW 

23 

PROCESSING 
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044300* 

044400* WHEN THE PROTECTED MODIFIED FIELD ON LINE 23 IS PROCESSED, EOL IS 
044500* SET TRUE AND THE BUFFER CONSIDERED PROCESSED. THE WHOLE PROCESS 
044600* STARTS OVER AGAIN AND A NEW BUFFER IS PROCESSED. 

044700* 

044800 IF TD-LOC-ROW = '003' 

044900 PERFORM ROW-3 

045000 

045100 ELSE IF TD-LOC-ROW = '005' 

045200 PERFORM ROW-5 

045210 

045220 ELSE IF TD-LOC-ROW = ’023’ 

045230 PERFORM ROW-23. 

045300 

046800* NOTE; IF ADDITIONAL LINES EXIST ON THE FORM 
046900* ADDITIONAL 'ELSE IF' LINES MAY BE CODED. 

047000* HOWEVER, THERE IS A LIMIT TO THE DEPTH TO WHICH 
047100* MOST COMPILERS WILL ALLOW IF'S TO BE NESTED. 

047200* TO OVERCOME THE NESTING LIMIT, START UP AN- 

047300* OTHER 'IF...THEN...ELSE’. 

049800 

049900 IF LINE-IS-EMPTY 

050000 NEXT SENTENCE 

050200 ELSE PERFORM GET-BUFFER-LINE. 

050300 

050500 * 

050600* WORK ROUTINES 
050700* 

050800* THESE ROUTINES FURTHER BREAK DOWN THE DATA JUST RECEIVED 

050900* FROM THE TERMINAL. EACH OF THE ROUTINES THAT FOLLOW 
051000* IS DEDICATED TO ONE ROW FROM THE TERMINAL. THESE ROUTINES WILL 
051100* EXAMINE THE COLUMN NUMBER AND TAKE APPROPRIATE ACTION. 

051200* IN THIS PROGRAM THE DATA IS JUST SAVED IN A DISK FILE 
051700* BUT ADDITIONAL PROCESSING COULD HAVE BEEN DONE. 

051800 * 

051900 

052000 ******* 

052100 ROW-3. 

052200 ******* 


052300 

052400 

052500 

052600 

052700 

052800 

052900 

053000 

053100 

053200 

053300 

053400 

053500 

053600 

053700 

053800 

053900 

054000 

054100 

054200 

054300 

054400 


IF TD-LOC-COL = '006' 




MOVE TD-DATA 

TO TF-REF 

ELSE 

IF 

TD-LOC-COL = 

*025’ 



MOVE TD-DATA 

TO TF-CUST-1 

ELSE 

IF 

TD-LOC-COL = 

*030* 



MOVE TD-DATA 

TO TF-CUST-2 

ELSE 

IF 

TD-LOC-COL = 

*053’ 



MOVE TD-DATA 

TO TF-INSTRUMENT 

ELSE 

IF 

TD-LOC-COL = 

*071 * 



MOVE TD-DATA 

TO TF-VALUE 

ELSE 






NEXT SENTENCE 



IF TF-REF = 'QUIT' 

MOVE 'EOL' TO LINE-IS-EMPTY-IND 
MOVE 'EOJ' TO END-OF-JOB-IND 
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054500 

ELSE 


054600 

054700 

054800*«*»««» 
054900 ROW-5. 
055000»»»»»»* 

055100 

NEXT SENTENCE 


055200 

IF TD-LOC-COL = ’Oil* 


055300 

055400 

MOVE TD-DATA 

TO TF-TYPE 

055500 

ELSE IF TD-LOC-COL = 

’027’ 

055600 

055700 

MOVE TD-DATA 

TO TF-FC-AMOUNT 

055800 

ELSE IF TD-LOC-COL = 

'048' 

055900 

056000 

MOVE TD-DATA 

TO TF-RATE 

056100 

ELSE IF TD-LOC-COL = 

'066' 

056200 

056300 

MOVE TD-DATA 

TO TF-DOLLARS 

056400 

ELSE 


056500 

056600 

056700*»»»»«» 
056800 ROW-7. 

056900******* 

NEXT SENTENCE 


057100 

IF TD-LOC-COL = ’012’ 


057200 

057300 

MOVE TD-DATA 

TO TF-OUR-ACCT 

057400 

ELSE IF TD-LOC-COL = 

’023’ 

057500 

057600 

MOVE TD-DATA 

TO TF-CONTRACT-NR 

057700 

ELSE IF TD-LOC-COL = 

'051 ' 

057800 

057900 

MOVE TD-DATA 

TO TF-CREDIT-REFERENCE 

058000 

ELSE IF TD-LOC-COL = 

'076' 

058100 

058200 

MOVE TD-DATA 

TO TF-CHECK-OK 

058300 

ELSE 


058400 

058500 

068100 

068200******** 

068300 ROW-23. 

068400******** 

068500 

NEXT SENTENCE. 

068600 

068700 

MOVE ’EOL’ TO LINE-IS 

-EMPTY-IND. 

068800 DISPLAY. 

-THE-FORM. 


071300* - 

071400 



071500 

DISPLAY TFFO-0. 


071600 

DISPLAY TFFO-1. 


071700 

DISPLAY TFFO-1A. 


071800 

DISPLAY TFFO-1B. 


071900 

DISPLAY TFFO-1C. 


072000 

DISPLAY TFFO-3. 


072100 

DISPLAY TFFO-3A. 


072200 

DISPLAY TFFO-3B. 


072300 

DISPLAY TFFO-3C. 


072400 

DISPLAY TFFO-3D. 


072500 

DISPLAY TFFO-3E. 
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072600 

DISPLAY 

TFFO-5. 

072700 

DISPLAY 

TFF0-5A. 

072800 

DISPLAY 

TFFO-5B. 

072900 

DISPLAY 

TFFO-5C. 

073100 

DISPLAY 

TFFO-7. 

073200 

DISPLAY 

TFF0-7A. 

073300 

DISPLAY 

TFFO-7B. 

073^00 

DISPLAY 

TFFO-7C. 

075600 

DISPLAY 

TFFO-EOD-FLAG. 

075700* 



075800* 



075900 

DISPLAY 

TFFO-END. 

076000* 



076100* 

<< PHYSICAL END OF PROGRAM >> 
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MEMORY CONSIDERATIONS 


It is possible for the terminal to use all of its display memory. Likewise, the terminal may 
use up all of its graphics memory. The comments in this appendix should help the 
programmer judge how much of each type of information can be sent to the terminal 
before running out of memory. 


DISPLAY MEMORY 

On the screen, a full line of text (a character displayed in every column) plus ten attribute 
codes uses 112 bytes (in the display list). A full screen of such lines (34 lines X 112 
bytes/line) uses about 3800 bytes. As a rule of thumb, then, you get about one full screen 
of display for every 4K bytes of display memory. Usually, of course, one does not use the 
full 80 columns of a line for display. A rough calculation of line length will give the proper 
adjustment factor. For example, if the program uses roughly 50% of each line for display, a 
16K byte display memory will store approximately; 

16K bytes x 1 screen x 2 = 8 34-line screens 
4K bytes 

The workspace and the monitor both use memory out of the same “pool” of display 
memory. When the terminal has used most of its display memory and you attempt to 
display more information, the result depends on which scroll is receiving information. 

If the terminal runs low on memory while you are sending information to the workspace, 
the terminal bell rings as a warning to the operator, and the terminal overprints a portion 
of the current line with incoming data. If information continues to come, the terminal soon 
refuses to print and the cursor sticks at its current location. 

If the terminal runs low on memory while you are sending information to the monitor, the 
cursor simply sticks at its current location and the terminal refuses to print new 
information. The terminal still processes a carriage return, however, and enough memory 
is saved to give at least one command. (If the monitor has scrolled information up past the 
top of the monitor window, the terminal discards this information as needed, line by line. 

In this case, you may keep sending information to the monitor, and the terminal will keep 
discarding scrolled up information.) 
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MEMORY CONSIDERATIONS 


An applications program may keep track of the amount of unused display memory by 
occasionally giving the command 

IREP 00<CR> 

This command causes the terminal to return a report to the computer in the following 
format: 

IANS 00,<p1>,<p2>; 

where <p1 > is a four-digit decimal number specifying the number of unused blocks of 
display memory. (A block consists of 16 8-bit bytes.) When <p1 > falls below a given 
level, the program can instruct the terminal to erase information by sending an ERASE, 
□LINE, or DCHAR command or, if the information displayed is not needed, a WORKSPACE 
or MONITOR command. To recover display memory from the computer, you must give 
some command which erases text. 

GRAPHICS MEMORY 

The terminal can contain 48K, 96K, 144K, or 192K bytes of graphics memory. The amount 
of graphics memory which a given graph requires depends on the density of information 
in the graph. The following is an estimate of how much graphics memory is required for 
graphic display. The term “pie chart” refers to a pie chart with 10 pieces. The term 
“graph” refers to a line graph of approximately the same density as the graph in Figure 8-8. 


Table F-1 

GRAPHIC MEMORY CAPACITY 


Amount of Graphic Memory 

Display Capacity 

48K bytes 

2-I-pie charts, or 2 line graphs 

96K bytes 

4 pie charts, or 3 to 4 line graphs 

144K bytes 

6 pie charts, or 6 to 7 line graphs 

192K bytes 

8 pie charts, or 7 to 8 line graphs 


@ 


F-2 


4027 PROGRAMMER’S 




Appendix G 


PROGRAMMER’S REFERENCE TABLE 


Please record the following settings for future reference: 


Transmitting Baud Rate 

TB = 

Receiving Baud Rate 

RB= 

Command Character 

CC = 

Prompt String 

PR = 

End-of-line String 

EL= 

Duplex (Full or Half) 

DU = 

Echo (Remote or Local) 

EC = 

Parity (None, Even, Odd, High, or Data) 

PA= 

Field Separator 

FS = 

End-of-File String 

EF= 

Send Key String 

Display Memory Capacity 

Graphics Memory Capacity 

Fonts Installed 

Options Installed 
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OPTION SUMMARY 


Option 1: Half Duplex 

Permits half duplex normal and supervisor modes in addition to the full duplex 
communications provided as standard equipment. 

Option 2: Current Loop 

Permits the 4027 to communicate with the host computer or another device by means of a 
20 mA current loop rather than the standard RS-232 interface. 

Option 3: RS-232 Peripheral Interface (Requires Option 36) 

Permits the 4027 to transmit to RS-232 compatible peripheral devices such as the 
Tektronix 4642 Printer. With this option, data from the host computer or the workspace 
can be printed on the 4642 Printer. Includes current loop board and L-bracket. 

Option 4: GPIB Peripheral Interface (Requires Option 36) 

Permits the 4027 to communicate with and control the Tektronix 4924 Digital Cartridge 
Tape Drive and 4662 Interactive Digital Plotter. These devices communicate with the 
4027 over the General Purpose Interface Bus (GPIB), which is defined in IEEE Standard 
488-1975. Allows the 4027 to save data or command files on the 4924, and retrieve them 
later without the need for intervention by the host computer. 


Option 10: Polling Interface (includes Option 2) 

Permits the 4027 to function in a polling environment, as one of several display stations 
communicating with the host computer through a polling controller. (See Option 11.) 

Option 11: Polling Controller 

The Tektronix polling system permits muitiple terminals to be connected to a single host 
communications port. The Polling Controller (Option 11) provides for control of up to eight 
additional display stations via a 20 mA current loop interface. Full duplex interface is 
provided at up to 4800 baud. 
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The Option 11 Polling Controller communicates with the host computer through an RS- 
232 port, using IBM 3271/3277 Bisynchronous EBCDIC protocol. 

In addition to the RS-232 port for communicating with the host and the current loop port 
for communicating with the display stations, the Option 11 Polling Controller includes a 
third communication port. This is an RS-232 transmit-only port for driving a printer. 


Options 21 and 22: Added Display Memory 

The standard 4027 includes 8192 bytes of display memory. (Each byte is 8 binary bits, 
and can hold one ASCII character.) Options 21 and 22 expand this, permitting larger 
quantities of text to be stored in the workspace and monitor. 

Option 21: A total of 16,384 (16K) bytes of display memory. 

Option 22: A total of 32,768 (32K) bytes of display memory. 


Options 27, 28, and 29: Color Graphics Memory 

Permits the 4027 to draw a variety of geometric shapes and panels in any of 64 possible 
colors. Solid lines and seven types of dashed lines can be drawn, and individual points 
can be plotted. Individual lines can be erased by drawing over them with “erase vectors.” 

In addition, the Graphics Memory options permit the user to create alternate character 
fonts for displaying text in the workspace, to create individual symbols and 120 user- 
defined patterns. 

These options differ only in the amount of graphics memory they include. Larger amounts 
of graphics memory permit the 4027 to perform more complex tasks in its workspace, and 
to create more alternate character sets. 

Option 27: 96K (total) bytes of graphics memory. 

Option 28: 144K (total) bytes of graphics memory. 

Option 29: 192K (total) bytes of graphics memory. 
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Option 31: Character Set Expansion. 

Permits the addition of ROMs (Read Only Memories) containing alternate character fonts. 

Option 32: Ruiing Characters (Requires Option 31) 

Adds the “ruling” character font, permitting single and double lines to be drawn on forms 
in the workspace, as well as ruling junctions characters. 


Option 34: Math Characters (Requires Option 31) 

Adds a set of “math” characters to permit mathematical symbols to be displayed in the 
workspace. Includes standard mathematical symbols, Greek letters, and superscripts. 


Option 36: Peripherais ROM 

Provides instructions for the 4027 processor, allowing it to communicate with RS-232 or 
GPIB peripheral devices. (Required for Option 3 or Option 4.) 


Option 42: Hard Copy and Video Out 

Permits the 4027 to copy the contents of its workspace, monitor, or screen on a Tektronix 
4632 Hard Copy Unit. The copies are each about 8 1 /2 by 11 inches in size, and can 
show 34 lines of the workspace or monitor contents. One or several 34-line pages may be 
copied. The copies can show rulings, special characters, and graphics, as well as 
ordinary text. 

Also permits the 4027 display to be viewed on a standard video monitor. 


Option 48: 220 Voit Power 

Enables the 4027 to operate from 220 volt 50 or 60 Hz power lines. 
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Appendix I 


ROUTINE EXTERNAL CONVERGENCE BOARD 

ADJUSTMENTS 



Routine external convergence board adjustments should be made by 
qualified personnel only. 


The external convergence board may need to be adjusted occasionally. Convergence 
should be checked when the terminal is first installed or whenever it is relocated. 

Proper convergence means that the red, green, and blue beams come to a point on the 
screen. If the convergence is not properly adjusted, red, green, and blue colors will appear 
on the perimeter of any white areas on the screen. If convergence appears to be out of 
adjustment, the following procedure should be used to adjust the external convergence 
board. 

Procedure for Routine Convergence Adjustments 

1. Type the CAL command (!CAL<CR>). 

This will cause a message to be displayed which assigns each of the function keys 
(F1 through F8) to a color and F9 to an alignment grid. Go through the function keys 
from F1 to F8 and check that the following colors appear; white, red, green, blue, 
yellow, cyan, magenta, and black. 

2. Remove the two screws securing the external convergence board tray and slide out 
the tray (Figure 1-1). 

The external convergence board contains 27 adjustments arranged in groups of 
three. Looking at the board from the front of the terminal, there is a direct 
correspondence between each of these groups and an area on the screen. For 
example, upper left on the board corresponds to upper left on the screen. In addition, 
the adjustments are color coded. Thus, the red adjustments control the red beam, the 
green adjustments control the green beam, and the blue adjustments control the 
blue beam. 

Refer to Figure I-1 for the direction of beam movement produced by the convergence 
adjustments. For a particular area, the red and green are converged first, then the 
blue is converged with them. 
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1-1. Adjusting the External Convergence Board. 


3. After the terminal has warmed up for 30 minutes, press the “degauss” button on the 
rear panel for 2 or 3 seconds. Press function key F9 to display the alignment grid. 

4. Begin adjusting in the center (first the red and green, then the blue) and continue in 
the following order: top center, bottom center, right center, left center, top right, 
bottom right, top left and bottom left. 

5. Once satisfactory convergence has been obtained, restore the external convergence 
board to its compartment. 
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Appendix J 


COMMAND LISTING 


Table J-1 

COMMAND LISTING 


Command 

Discussed 
on Page 

Options 

Required 

Action 

Different in 

Form Fillout 

Mode 

other 

Comments 

ALLOCATE 

11-11 

4 



ATTRIBUTE 

9-10 


Logical attributes 
effective only in 
Form Fillout Mode 

Workspace Only 

BACKTAB 

6-16, 9-23 


X 


BAUD 

5-13 




BELL 

6-23 




BUFFERED 

5-19 




CIRCLE 

8-19 




CLEAR 

4-9 




COLOR 

7-2 




COMMAND 

2-9, 5-2 




COPY 

11-21 

3 or 4 

X 


DCHAR 

10-1 


X 


DELAY 

5-25 




DIRECTORY 

8-38 




DISABLE 

11-14 




DISCONNECT 

8-6 

1 



DFONT 

5-31 




DUNE 

10-6 


X 


DOWN 

6-8 




DUPLEX 

5-29 

1 



ECHO 

5-17 




EOF 

5-28 

3 or 4 



EOL 

5-21 




ENABLE 

8-4 




ERASE (Workspace 
and Monitor) 

6-22, 9-25 


X 


ERASE (Graphics) 

8-26 
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Table J-1 (cent) 
COMMAND LISTING 


Command 

Discussed 
on Page 

Options 

Required 

Action 

Different in 

Form Fiilout 

Mode 

other 

Comments 

EXPAND 

4-7 




FIELD 

5-26, 9-29 




FONT 

8-32 




FORM 

5-10, 9-3 




GRAPHIC 

8-2 




GTEST 

5-37 




HCOPY 

11-26 

42 



HRULE 

9-16 

32 



ICHAR 

10-3 


X 


ILINE 

10-10 


X 


INK 

8-22 




JUMP 

6-2, 9-13, 9-26 



Workspace only 

KILL 

11-16 

4 



LEARN 

4-2, 4-7 




LEFT 

6-12 




LINE 

8-11 




MAP 

7-3 




MARGINS 

5-7 



Workspace only 

MIX 

7-7 




MONITOR 

5-5 




PARITY 

5-15 




PASS 

11-17 

4 



PATTERN 

7-8 




PERIPHERALS 

11-7 

4 



PIE 

8-16 




POLY 

8-12 




PROMPT 

5-23 




REPORT 

3-11,11-8 



From the host only. 
Some forms require 
options. 

RDOWN 

6-20 




RIGHT 

6-10 




RMAP 

7-5 
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Table J-1 (cent) 
COMMAND LISTING 


Command 

Discussed 
on Page 

Options 

Required 

Action 

Different in 
Form Fillout 

Mode 

other 

Comments 

RPOLY 

8-14 




RUP 

6-18 




RVECTOR 

8-9 




SEND 

3-8, 9-27 


X 


SET 

11-2 

3 or 4 



SHRINK 

8-28 




SNOOPY 

5-11 




STOPS 

5-9 




STRING 

8-24 




SYMBOL 

8-35 




SYSTAT 

5-32 




TAB 

6-14, 9-21 


X 


TEST 

5-35 




UP 

6-5 




VECTOR 

8-7 




VRULE 

9-17 

32 



WORKSPACE 

5-3 
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V 








INDEX 


ALLOCATE Command.11-11 

ANSWER.3-11,11-8 

ASCII Code Chart.8-1 

ASCII strings, delimited.2-4 

ATTRIBUTE Command.9-10 

Attributes 

alphanumeric.9-7 

codes.8-29, 9-9 

field.9-6 

font.9-6, 9-11 

logical.9-7, 9-1 2 

numeric.9-7 

protected.9-7 

visual.9-8, 9-12 

4025-Style.9-9 

BACKTAB Command.6-16, 9-23 

BAUD Command.5-13 

BELL Command.6-23 

BUFFERED Command.5-9 

CIRCLE Command.8-19 

CLEAR Command.4-9 

COLOR Command.7-2 

Color 

background.7-8,8-35,8-37 

boundary.7-2 

foreground.7-8,8-35,8-37 

vector.7-2 

Color Standard, Tektronix 4027 .A-1 

COPY Command.11-21 

COMMAND Command.2-9, 5-2 

Command, descriptions of syntax.2-6 

Command file, displaying.3-7 

Commands, format.2-2 

Commands, invalid.3-5 

COPY Switches.11-22 

Crosshair.6-1,8-4, 8-29 

Cursor.1-7, 6-1,8-29 
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INDEX 


DCHAR (Delete Character) Command.8-29, 10-1 

DELAY Command.5-25 

DFONT Command.8-38 

DISABLE Command.8-6 

DISCONNECT Command.5-31 

DIRECTORY Command.11-14 

Display unit.1-2 

DLINE (Delete Line) Command.8-29,10-6 

DOWN Command.6-8 

DUPLEX Command.5-29 

ECHO Command.5-17 

ENABLE Command.8-4 

End angle.8-16, 8-19 

EOF (End-of-File) Command.5-28 

EOL (End-of-Line) Command.5-21 

ERASE Command, workspace and monitor.6-22, 9-25 

ERASE G Command.8-26 

EXPAND Command.4-7 

FIELD Command.5-26 

Field attribute codes.9-6 

Fields 

creating with JUMP.9-13 

Form Fillout Mode.9-29 

unprotected.9-30 

FONT Command.8-37 

Fonts, alternate character.8-34 

FORM Command.5-10, 9-3 

Form, creating.9-4 

Form Fillout Mode.9-1,9-20 

Forms, Transmitting .9-27,9-30 

GIN (Graphic Input) Mode.8-4 

Graphic beam.8-4, 8-32 

GRAPHIC Command.8-2 

Graphic region 

coordinate system.8-2 

Graphic 

color.8-1 

memory.F-2 

4010-Style.8-32 

GTEST Command.5-37 
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INDEX 


HCOPY (Hard Copy) Command.11-26 

HRULE (Horizontal Rule) Command.9-16 

Hue angle.7-3, 7-5 

ICHAR (Insert Character) Command.10-3 

ILINE (Insert Line) Command.10-10 

INK Command.8-22 

Increment angle.8-16, 8-19 

Interfaces, optional.1-4, H-1 

JUMP Command.6-2, 9-13, 9-26 

Junctions, making correct.9-18 

Key definitions, clearing.4-9 

Key Programming.4-1,4-8 

Keyboard.1-7,1-11 

Keys 

ASCII.1-8 

Cursor/Numeric Pad.1-8 

Function.1-9 

KILL Command.11-16 

LEARN Command.4-2, 4-7 

LEFT Command.6-12 

LINE Command..8-11 

Lightness.7-3, 7-5 

Macros.4-6 

MAP Command.7-3 

MARGINS Command.5-7 

Memory 

display.F-1 

graphic.F-2 

MIX Command.7-7 

Monitor.1-5 

MONITOR Command.5-5 

Numeric parameters.3-3 

PARITY Command.5-15 

PASS Command.11-17 

PATTERN Command.7-8 

PERIPHERALS Command.11-7 

Peripherals Data List.11-7 

Peripherais supported.11-1 
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INDEX 


PIE Command.8-16 

Plotter Language Commands.11-18 

Polling.H-1 

POLYGON Command.8-12 

PROMPT Command.5-23 

Raster unit.8-16 

RDOWN (Roll Down) Command.6-20 

REPORT Command.3-11,11-8 

RGB (Red-Green-Blue).7-7 

RIGHT Command.6-10 

RMAP Command.7-5 

ROM checksums.5-35 

RPOLYGON (Relative Polygon) Command.8-14 

Rulings.9-16 

RUP (Roll Up) Command.6-18 

RVECTOR (Relative Vector) Command.8-9 

Saturation.7-3, 7-5 

Scrolling.6-18 

SEND Command.3-8, 8-29, 9-27 

SET Command.11-2 

SHRINK Command..8-28 

SNOOPY Command.5-11 

Split screen.1-5 

Start angle.8-16, 8-19 

Status messages.5-32 

STOPS Command.5-9 

STRING Command.8-24 

Switches, COPY.11-22 

SYMBOL Command.8-35 

SYSTAT (System Status) message.5-32 

TAB Command.6-14, 9-21 

TEST Command.5-35 

Text and commands.3-1 

UP Command.6-5 

VECTOR Command.8-7 

Vector LINE types...8-11 

Visual enhancements (attributes).9-8, 9-12 

VRULE (Vertical Rule) Command.9-17 

Workspace.1-5 

WORKSPACE Command.5-3 
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